Verziók kezelése

Honosítás, amely nem késlelteti a megjelentetéseket

A honosítás legfontosabb kérdése valószínűleg az, hogy hogyan tartsa vissza a megjelentetést, amíg az utoljára hozzáadott szövegek lefordításra nem kerülnek. A Crowdin verziókezelési funkciója drámai módon csökkenti a késedelmet. Ez a szolgáltatás kulcsfontosságú azoknak a projekteknek, amelyek egynél több változatot tartanak fenn.

Szokásos alkalmazás honosítási munkafolyamat

Az alkalmazások honosításának szokásos megközelítése a következőképpen néz ki:

  • A fejlesztők a saját kód-águkon végzett módosításokon dolgoznak
  • Az ág a master vagy más, a master-hoz hasonló megjelentetés előtti ággal kerül egyesítésre és ott marad, amíg az újonnan hozzáadott összes szöveg lefordításra nem kerül

Fő probléma

A legtöbb esetben az alkalmazást néhány fejlesztő egyidejűleg fejleszti. Külön verzió-ágakban dolgoznak, egy verziókezelő rendszeren belül (GIT). A klasszikus honosítási folyamat a következő: az új szövegek feltöltésre kerülnek a “master” ágból a fordító szerverre.

A Branch 1 és Branch 2 ágak szövegei csak azután kerülnek a fordító szerverre, miután egyesítették azokat a master ággal, ahelyett, hogy azonnal elérhető lenne a fordításra.

Megoldás

Az új megközelítéssel a fordítás azonnal megkezdődhet, miután az új szövegek megjelennek bármelyik kód-ágban. Ha a későbbi (feature) ág a megjelentetés előtti vagy master ággal egyesítésre kerül, az új szövegek fordításai már bevetésre készen állnak.

Megvalósítása a Crowdinban

Amikor a fordítók egy olyan projekten dolgoznak, melyhez a Crowdinba az összes ágat feltöltötték, a platform csak azokat az ágakat fogja kiemelni nekik, amelyek különböznek. Ez azt jelenti, hogy a fordítók nem fordítják az ismétlődéseket.

Használatának megkezdése

Az ágak fordítási funkciójának engedélyezéséhez a projektben a Projekt beállítások, Általános fülön állítsa be a következő beállítást.

Bármely forrásszöveg akkor tekinthető ismétlődésnek, ha ugyanaz a szöveg szerepel a fájl különböző verzióiban (eltérő ág), így az nem jelenik meg a fordítónak. Ha egyszer lefordításra került, a többi ágban lévő ismétlődő szövegek automatikusan ezzel a fordítással lesznek ellátva.

Verzió-ág létrehozása

Általánosságban, a Crowdin egy ága egy szokásos könyvtár, melyet egy speciális ikon jelöl, emellett kezeli az ismétlődő karakterláncokat. Ágakat a Projekt beállítások, Fájlok fülön keresztül vagy az [API]/[Szinkronizálási eszköz] (ajánlott) segítségével hozhat létre.

Ha GitHub, Bitbucket vagy más VCS integrációt használ, a honosításra kijelölt ágakhoz a Crowdin automatikusan létrehozza.

Fájlszerkezet példa a verziókezelő rendszerben, valamint a Crowdinban:

Fontos! A projekt gyökérkönyvtára is úgy viselkedik az ismétlődésekkel, mint egy külön verzió-ág. Például a “master” ág fájljait közvetlenül a projekt gyökérkönyvtárában tárolhatja, anélkül, hogy egy külön verzió-ágként megjelölt könyvtárba helyezné őket.

Ágak létrehozása API segítségével

Az API segítségével történő ág létrehozásához használja az Add Directory módszert az is_branch=1 paraméterrel:

POST https://api.crowdin.com/api/project/{project-identifier}/add-directory?key={project-key}&name={branch_name}&is_branch=1

Add File, Update File, Upload Translations és a többi, fájlokat és könyvtárakat módosító módszerek a branch={branch_name} paraméterrel működnek.

Ágak kezelése a Szinkronizálási eszközzel

A szinkronizálási eszköz használata esetén nincs szükség külön parancs futtatására. A fájlok feltöltése közben a verzió-ág automatikusan létrejön. Példa a forrásfájlok/fordítások feltöltésére egy megadott verzió-ágba:

$ crowdin upload sources -b branch_name

$ crowdin upload translations -b branch_name

Fordítások exportálása

Az összes verzió-ágból származó fordítások egy ZIP archívumba kerülnek, ha azokat a webes felületen keresztül töltik le. A szinkronizálási eszköz vagy az API használatával külön-külön letöltheti a verzió ágak fordításait.

Fordítások exportálása API segítségével

Megadott verzió-ág fordításának exportálása:

GET https://api.crowdin.com/api/project/{project-identifier}/export?key={project-key}&branch={branch_name}

Megadott verzió-ág fordításainak letöltéséhez:

GET https://api.crowdin.com/api/project/{project-identifier}/download/{package}.zip?key={project-key}&branch={branch_name}

Fordítások exportálása a Szinkronizálási eszköz segítségével

Megadott verzió-ág fordításainak letöltéséhez:

$ crowdin download -b branch_name

Ágak egyesítése

Miután a jövőbeli funkció (feature) fejlesztése befejeződött, egy mérnök egyesíti a verzió-ágat a master ággal a verziókezelő rendszerben (VCS). Következésképpen, a master ág tartalmazni fogja a feature ág új szövegeit. A Crowdinnal való szinkronizálás során a master ágban lévő összes szöveg kiegészül a megfelelő ágban korábban végrehajtott fordításokkal.

A frissített master Crowdinnal való szinkronizálása után a feature ágat el lehet távolítani a Crowdinról, a master ágban tárolt fordítások továbbra is megmaradnak.

Ajánlott munkafolyamat

Az új munkafolyamat, amelyet a Crowdin végrehajtásra javasol:

Fontos, hogy átgondolja és megvitassa az új munkafolyamatot a fejlesztőcsapattal. A csapaton belüli a legfontosabb megállapodás az, hogy ne írjanak olyan szövegeket, amelyek valószínűleg nem fognak eljutni a kiadásba.

GitHub munkafolyamat és Crowdin

A módosításokat a feature ágba küldheti, hogy az építés során ellenőrizze őket.

Hasznos volt ez a cikk?