API lokalizacji Androida (XML)

Localization.One oferuje natywne wsparcie dla procesów deweloperskich Androida. Zamiast zajmować się ogólnymi plikami JSON i pisać niestandardowe skrypty konwersji, możesz eksportować swoje tłumaczenia bezpośrednio w standardowym formacie strings.xml wymaganym przez Android Studio.

Dlaczego deweloperzy wybierają nasze API Androida?

  • Format natywny: Generujemy poprawny XML gotowy do res/values/strings.xml.
  • Inteligentne ucieczki: Automatycznie obsługujemy znaki specjalne. Apostrofy (') stają się \', a ampersandy są ucieczone, co zapobiega błędom kompilacji w Android Studio.
  • Sanitizacja kluczy: Jeśli Twoje klucze tłumaczeń zawierają spacje lub myślniki (np. "Menu główne"), automatycznie konwertujemy je na poprawne identyfikatory zasobów w formacie snake_case (main_menu).

Zaawansowane zarządzanie projektami

Oferujemy potężne narzędzia do organizacji lokalizacji, niezależnie od tego, jak duży staje się Twój projekt.

Kategoryzacja: Grupuj swoje ciągi w logiczną strukturę folderów (np. Auth > Logowanie, Profil > Ustawienia).

Etykiety i tagi: Oznaczaj ciągi niestandardowymi etykietami, aby filtrować eksporty przez API.

Role i uprawnienia: Zapraszaj nieograniczoną liczbę członków zespołu i przypisuj szczegółowe role (Właściciel, Administrator, Menedżer, Tłumacz).

Webhooki: Automatycznie uruchamiaj swoje kompilacje CI/CD, gdy tłumaczenia są aktualizowane.

Jak pobrać

Opcja 1: Ręczny eksport (UI)

Idealne do testowania lub jednorazowych aktualizacji.

  1. Przejdź do swojego Panelu projektu.
  2. Kliknij przycisk Pobierz .
  3. Wybierz Android XML z rozwijanego menu formatu.
  4. Wybierz język i natychmiast pobierz plik strings.xml.

Opcja 2: Automatyzacja za pomocą API (CI/CD)

Pobierz najnowsze tłumaczenia bezpośrednio z Twojego procesu budowy za pomocą prostego polecenia cURL. Przekaż swój token API znajdujący się w ustawieniach "API i Webhook".

# Pobierz angielskie tłumaczenia i zapisz do strings.xml
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=1&format=xml-android" > app/src/main/res/values/strings.xml

Opcja 3: Wysyłanie przez Webhooki

W pełni zautomatyzuj swój proces pracy. Skonfiguruj URL webhooka w ustawieniach projektu, a my natychmiast powiadomimy Twój serwer, gdy tłumaczenia zostaną zaktualizowane lub zatwierdzone.

  • Szybkie aktualizacje: Twój serwer otrzymuje żądanie POST krótko po zmianach (zwykle w ciągu 5 minut).
  • Uruchamiaj kompilacje: Użyj webhooków, aby automatycznie uruchomić nową kompilację w Jenkinsie lub GitHub Actions.
  • Synchronizuj CMS: Automatycznie aktualizuj treści na swojej stronie internetowej lub backendzie bez potrzeby odpytywania API.

Najczęściej zadawane pytania

Czy wspieracie tablice ciągów?

Obecnie nasze API eksportuje pojedyncze elementy <string>. Jeśli potrzebujesz <string-array>, zalecamy grupowanie ich przy użyciu konwencji nazewnictwa (np. items_0, items_1) i mapowanie ich w swoim kodzie lub skontaktowanie się z pomocą techniczną w celu uzyskania niestandardowych opcji eksportu.

A co z liczbami mnogimi?

Traktujemy formy mnogie jako oddzielne klucze, aby zapewnić zgodność na wszystkich platformach. Możesz je mapować ręcznie w swoim strings.xml lub użyć naszej konwencji nazewnictwa kluczy (np. apple_one, apple_other).

Odkryj inne rozwiązania mobilne:

Gotowy, aby zautomatyzować swoją lokalizację? Załóż swoje darmowe konto już dziś.