Dezvoltatori

Dacă sunteți programator (sau doriți să deveniți programator) și sunteți interesat să dezvoltați funcții noi, să remediați erori sau să îmbunătățiți interfața utilizator pentru OpenShot, secțiunile următoare vă vor explica cum să începeți și să vă implicați!

Imaginea de ansamblu

OpenShot Video Editor are 3 componente principale: o interfață utilizator Python & PyQt (openshot-qt), o bibliotecă audio C++ (libopenshot-audio) și o bibliotecă video C++ (libopenshot). Dacă nu sunteți familiarizat cu Python, PyQt sau C++, acestea ar fi subiecte excelente pentru a le cerceta și a învăța mai multe în acest moment.

Totuși, multe erori pot fi remediate și funcții noi adăugate doar cu cunoștințe de Python, deoarece componentele C++ nu sunt implicate deloc în interfața utilizator. Python este un limbaj uimitor, foarte distractiv de învățat și este singura abilitate prealabilă necesară pentru a deveni dezvoltator OpenShot!

Atenționare

Instrucțiunile care urmează sunt pentru Ubuntu Linux, care este cel mai ușor mediu de configurat pentru dezvoltarea OpenShot. Dacă folosiți un alt sistem de operare, vă sugerez să rulați o mașină virtuală cu Ubuntu LTS înainte de a continua.

Dacă trebuie să folosiți un sistem Windows sau Mac pentru dezvoltare, începeți consultând notele de construire din wiki-ul libopenshot. Construirea bibliotecii cu toate dependențele sale este cea mai dificilă parte a procesului.

Obținerea celui mai recent cod sursă

Înainte să putem remedia erori sau adăuga funcții, trebuie să obținem codul sursă pe calculatorul dumneavoastră.

Folosiți git pentru a clona cele 3 depozite ale noastre:

git clone https://github.com/OpenShot/libopenshot-audio.git
git clone https://github.com/OpenShot/libopenshot.git
git clone https://github.com/OpenShot/openshot-qt.git

Configurarea mediului de dezvoltare

Pentru a compila sau rula efectiv OpenShot, trebuie să instalăm câteva dependențe pe sistemul dumneavoastră. Cel mai simplu mod de a face acest lucru este cu Daily PPA al nostru. Un PPA este un depozit neoficial Ubuntu, care conține pachetele noastre software disponibile pentru descărcare și instalare.

sudo add-apt-repository ppa:openshot.developers/libopenshot-daily
sudo apt-get update
sudo apt-get install openshot-qt \
                     cmake \
                     libx11-dev \
                     libasound2-dev \
                     libavcodec-dev \
                     libavdevice-dev \
                     libavfilter-dev \
                     libavformat-dev \
                     libavresample-dev \
                     libavutil-dev \
                     libfdk-aac-dev \
                     libfreetype6-dev \
                     libjsoncpp-dev \
                     libmagick++-dev \
                     libopenshot-audio-dev \
                     libprotobuf-dev \
                     libqt5svg5-dev \
                     libswscale-dev \
                     libunittest++-dev \
                     libxcursor-dev \
                     libxinerama-dev \
                     libxrandr-dev \
                     libzmq3-dev \
                     pkg-config \
                     python3-dev \
                     protobuf-compiler \
                     qtbase5-dev \
                     libqt5svg5-dev \
                     libxcb-xfixes0-dev \
                     qtmultimedia5-dev \
                     swig

În acest moment, ar trebui să aveți codul sursă al tuturor celor 3 componente OpenShot clonat în foldere locale, PPA-ul zilnic OpenShot instalat și toate dependențele necesare pentru dezvoltare și rulare instalate. Este un început excelent și suntem acum gata să începem compilarea codului!

libopenshot-audio (Instrucțiuni de construire)

Această bibliotecă este necesară pentru redarea audio și efecte audio. Se bazează pe cadrul audio JUCE. Iată comenzile pentru a o construi:

cd libopenshot-audio
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=dist ..
make
make install

Practic, schimbăm directorul în libopenshot-audio/build, apoi rulăm cmake .. în folderul părinte. Aceasta găsește dependențele și creează toate Makefile-urile necesare pentru a compila această bibliotecă. Apoi, make folosește aceste Makefile-uri pentru a compila biblioteca, iar make install le instalează în locația specificată. Dacă CMAKE_INSTALL_PREFIX nu este setat, fișierele se vor instala implicit în /usr/local/, iar make install va necesita privilegii administrative.

libopenshot (Instrucțiuni de construire)

Această bibliotecă este necesară pentru decodarea video, codare, animație și aproape tot ce ține de video. Ea face toată munca grea a editării și redării video. Iată comenzile pentru a o construi:

cd libopenshot
mkdir build
cd build
cmake -DLIBOPENSHOT_AUDIO_DIR=../../libopenshot-audio/build/dist ..
make

Practic, schimbăm directorul în libopenshot/build, apoi rulăm cmake .. în folderul părinte. Aceasta găsește dependențele și creează toate Makefile-urile necesare pentru a compila această bibliotecă. Apoi, make folosește aceste Makefile-uri pentru a compila biblioteca. Deoarece am specificat locația instalării compilate a libopenshot-audio, acea versiune a bibliotecii va fi folosită în locul celei din sistem (dacă există).

Nu instalăm libopenshot după compilare, deoarece nu este necesar. Pentru testare, putem spune OpenShot să folosească libopenshot direct din directorul nostru build.

Legături pentru limbaje

API-ul libopenshot este disponibil în mai multe limbaje prin legături SWIG. Python este folosit de interfața OpenShot, iar noi oferim și legături pentru Ruby și Java. Suport experimental pentru Godot 4.4 este inclus pentru dezvoltatorii care doresc să integreze funcții de editare video în motorul de joc Godot. Toate aceste legături se mapează pe aceeași bază de cod C++, astfel încât să puteți edita video din mediul preferat.

openshot-qt (Instrucțiuni de lansare)

Aceasta este aplicația noastră principală PyQt Python. Deoarece este scrisă în Python, nu necesită compilare pentru a rula. Pentru a lansa OpenShot din codul sursă cu bibliotecile noastre recent compilate libopenshot-audio și libopenshot, folosiți următoarele comenzi:

cd openshot-qt
PYTHONPATH=../libopenshot/build/src/bindings/python
python3 src/launch.py

Aceasta ar trebui să lanseze interfața utilizator OpenShot. Orice modificări pe care le-ați făcut în fișierele sursă (fișiere Python *.py, fișiere UI PyQt *.ui, etc…) vor fi incluse. Aceasta necesită bibliotecile libopenshot-audio și libopenshot, iar dacă ceva a mers prost în pașii de mai sus, OpenShot probabil nu se va lansa.

Dacă OpenShot se lansează în acest moment, felicitări! Acum aveți o versiune locală funcțională a OpenShot, care rulează din codul sursă local. Încercați să faceți câteva modificări în codul sursă și să relansați OpenShot… acum ar trebui să vedeți modificările!

Probleme GitHub

Acum că ați compilat și lansat cu succes OpenShot Video Editor din codul sursă, asigurați-vă că verificați lista noastră de rapoarte de erori pe GitHub: OpenShot Issues. De asemenea, vă încurajăm să completați rapid formularul de contribuție și să vă prezentați!