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艣.