Edytor tłumaczeń udostępnia skonsolidowany i edytowalny widok wszystkich domyślnych i przetłumaczonych zasobów tekstowych.
Wprowadzenie do tłumaczenia aplikacji na różne języki znajdziesz w artykule Obsługa różnych języków i kultur.
Zasoby tekstowe
Zasoby tekstowe projektu są zawarte w plikach strings.xml. Projekt zawiera domyślny plik strings.xml, który zawiera zasoby tekstowe w domyślnym języku aplikacji, czyli języku, którym posługuje się większość jej użytkowników. Możesz też mieć przetłumaczone pliki strings.xml, które zawierają zasoby tekstowe w innych językach, które chcesz obsługiwać w aplikacji.
Gdy masz już gotowy domyślny plik strings.xml, możesz samodzielnie dodać tłumaczenia lub zlecić ich wykonanie usługom specjalistycznym.
W obu przypadkach warto skorzystać z funkcji Android Studio, które pomagają zarządzać tekstem do przetłumaczenia i go testować. Informacje o profesjonalnych usługach tłumaczeniowych znajdziesz w artykule Usługi tłumaczeniowe.
Otwieranie edytora tłumaczeń
Edytor tłumaczeń możesz otworzyć w tych miejscach w Android Studio:
Otwieranie z widoku Androida
- W panelu Projekt > Android po lewej stronie wybierz ModuleName > res > values.
Kliknij prawym przyciskiem myszy plik strings.xml i wybierz Open Translations Editor (Otwórz edytor tłumaczeń).
Edytor tłumaczeń wyświetla pary klucz-wartość z pliku
strings.xml.
Rysunek 1 przedstawia domyślny tekst aplikacji (w tym przypadku w języku angielskim) w edytorze tłumaczeń przed rozpoczęciem tłumaczenia. Treść przetłumaczonych plików strings.xml pojawi się po prawej stronie kolumny Untranslatable (Nie do przetłumaczenia), z jedną kolumną na język, jak pokazano na rysunku 2.
Otwieranie z pliku strings.xml
Edytor tłumaczeń możesz otworzyć z poziomu dowolnego pliku strings.xml.
- W panelu Projekt > Android po lewej stronie wybierz ModuleName > res > values.
- Kliknij dwukrotnie plik strings.xml, aby otworzyć go do edycji.
- W pliku strings.xml kliknij link Otwórz edytor w prawym górnym rogu.
Konfigurowanie wierszy, których nie można przetłumaczyć
W edytorze tłumaczeń możesz wybrać opcję Nie do przetłumaczenia, aby wskazać, że nie chcesz, aby tekst w tym wierszu został przetłumaczony. Tekst, którego nie chcesz tłumaczyć, może być tekstem dotyczącym konkretnego produktu, np. nazwami handlowymi i znakami towarowymi, lub terminami technicznymi, które nie mają tłumaczenia.
Gdy wybierzesz Nie do przetłumaczenia, do odpowiedniego wiersza w domyślnym pliku strings.xml zostanie dodany ciąg translatable="false". W poniższym przykładzie nazwa EasyApp w górnym wierszu nie jest przetłumaczona, ponieważ jest to nazwa produktu.
<resources>
<string name="app_name" translatable="false">EasyApp</string>
<string name="action_settings">Settings</string>
<string name="easy_app">I am a Simple App!</string>
<string name="next_page">Next Page</string>
<string name="second_page_message">I am the Second Page!</string>
<string name="title_activity_second">SecondActivity</string>
</resources>
Dodawanie i usuwanie języków
Edytor tłumaczeń obsługuje standard BCP 47 i łączy kody języka i regionu (kraju) w jedną opcję wyboru na potrzeby kierowania lokalizacji. Ustawienia regionalne określają więcej niż tylko język. Ustawienia regionalne obejmują formatowanie zależne od kraju, np. daty i godziny, waluty i ułamki dziesiętne.
Aby dodać język:
- W edytorze tłumaczeń kliknij ikonę kuli ziemskiej
. Z listy wybierz język, który chcesz dodać.
Nowy język pojawi się w edytorze tłumaczeń, a do projektu zostanie dodany folder values-* z plikiem
strings.xml. Na przykład values-es dla języka hiszpańskiego.
Aby usunąć język:
Możesz usunąć język w edytorze tłumaczeń, usuwając każdą wartość w kolumnie (patrz Edytowanie, dodawanie i usuwanie tekstu), lub usunąć folder projektu dla tego języka w ten sposób:
- W panelu Projekt > Android po lewej stronie wybierz ModuleName > res.
- Kliknij prawym przyciskiem myszy folder values-* języka, który chcesz usunąć. Na przykład values-hi w przypadku języka hindi.
- Z listy wybierz Usuń, aby usunąć folder i jego plik strings.xml.
Edytowanie, dodawanie i usuwanie tekstu
Ustawienia tekstu możesz zmieniać bezpośrednio w pliku strings.xml lub w edytorze tłumaczeń. W tej sekcji opisujemy podejście z użyciem edytora tłumaczeń. W edytorze tłumaczeń możesz edytować, dodawać i usuwać tekst w widoku listy lub w polu Tłumaczenie u dołu edytora tłumaczeń.
Widok listy
Aby edytować lub dodać tekst, wykonaj te czynności:
- Kliknij dwukrotnie komórkę, w której chcesz edytować lub dodać tekst.
- Skopiuj i wklej za pomocą klawiatury lub, jeśli masz klawiaturę obsługującą znaki diakrytyczne, wpisz je bezpośrednio w widoku listy.
- Naciśnij Tab lub przesuń kursor poza pole.
Aby usunąć tekst:
- Kliknij dwukrotnie komórkę, którą chcesz usunąć.
- W widoku listy zaznacz tekst i naciśnij Delete.
- Naciśnij Tab lub przesuń kursor poza pole.
Pole tłumaczenia
Aby edytować lub dodać tekst, wykonaj te czynności:
- W widoku listy kliknij raz komórkę, w której chcesz edytować lub dodać tekst.
- W polu Tłumaczenie skopiuj i wklej tekst za pomocą klawiatury lub, jeśli masz klawiaturę obsługującą znaki diakrytyczne, wpisz tekst bezpośrednio w polu Tłumaczenie.
- Naciśnij Tab lub przesuń kursor poza pole.
Aby usunąć tekst:
- Kliknij raz komórkę, którą chcesz usunąć.
- W polu Tłumaczenie zaznacz tekst i naciśnij Delete.
Dodawanie i usuwanie kluczy
W edytorze tłumaczeń kolumna Klucz zawiera unikalne identyfikatory poszczególnych elementów danych w plikach strings.xml. Klucze możesz dodawać i usuwać w edytorze tłumaczeń. Gdy usuniesz klucz, Edytor tłumaczeń usunie go wraz ze wszystkimi powiązanymi tłumaczeniami. Edytor tłumaczeń używa refaktoryzacji bezpiecznego usuwania, aby usunąć klucz. Dzięki temu wiesz, czy tekst klucza jest używany w innym miejscu, i możesz wprowadzić niezbędne zmiany przed usunięciem klucza. Refaktoryzacja Bezpieczne usuwanie zapewnia, że kod będzie się kompilować po usunięciu klucza.
Aby dodać klucz:
- W edytorze tłumaczeń kliknij Dodaj klucz
. W oknie wpisz nazwę klucza, wartość domyślną i lokalizację domyślnego pliku strings.xml.
Rysunek 3. Dodawanie klucza
Aby usunąć klucz:
- W edytorze tłumaczeń wybierz klucz, który chcesz usunąć.
- Kliknij Usuń klucze
. W oknie Usuń zdecyduj, czy chcesz bezpiecznie usunąć i czy chcesz wyszukiwać w komentarzach i ciągach znaków, a następnie kliknij OK.
Rysunek 4. Okno usuwania Jeśli nie ma odwołań (użyć) do usuniętego klucza lub jeśli wszystkie odwołania można bezpiecznie zwinąć, klucz zostanie usunięty. W przeciwnym razie Edytor tłumaczeń wyświetli okno Wykryto użycie z informacjami o wykrytych problemach.
Rysunek 5. Usages Detected dialog Kliknij Wyświetl użycie, aby sprawdzić, co zostanie usunięte. W oknie Find Safe Delete Conflicts (Znajdź konflikty bezpiecznego usuwania) wyświetlane są wszystkie przypadki użycia, których nie można bezpiecznie usunąć, dzięki czemu możesz edytować odpowiedni kod.
Rysunek 6. Niebezpieczne zastosowania Kliknij prawym przyciskiem myszy użycie, aby wyświetlić menu kontekstowe, i wybierz Przejdź do źródła, aby wprowadzić potrzebne zmiany.
W panelu Znajdź konflikty bezpiecznego usuwania wybierz Uruchom ponownie bezpieczne usuwanie, aby upewnić się, że nie ma innych zastosowań, które wymagają uwagi.
Po usunięciu wystąpień kliknij Do Refactor (Przeprowadź refaktoryzację), aby usunąć klucz.
Popraw błędy
Rysunek 7 przedstawia edytor tłumaczeń z zawartością plików strings.xml w językach angielskim, francuskim i hiszpańskim. Czerwony tekst oznacza wiersze,
w których występują błędy.
Aby poprawić błąd, najedź kursorem na czerwony tekst, aby wyświetlić wyjaśnienie problemu i jego rozwiązanie.
Gdy wprowadzisz zmiany w edytorze tłumaczeń, pliki strings.xml zostaną zaktualizowane. Gdy wprowadzisz zmiany w pliku strings.xml, odpowiednia kolumna w edytorze tłumaczeń zostanie zaktualizowana.
Przykładowe poprawki w edytorze tłumaczeń:
- Na rysunku 7 widać, że w wierszu app_name zaznaczono opcję Untranslatable (Nie do przetłumaczenia), ale podano tłumaczenie na język hiszpański. Aby poprawić błąd, usuń tłumaczenie na język hiszpański.
- Na rysunku 7 widać, że w wierszu next_page brakuje tłumaczenia na język francuski. Użyj klawiatury, aby skopiować Page Suivante do komórki i poprawić błąd. Operacja kopiowania i wklejania za pomocą klawiatury kopiuje tekst ze znakami diakrytycznymi do komórki.
Zarządzanie tekstem do zlokalizowania i testowanie go
Platforma Androida i Android Studio udostępniają kilka funkcji, które pomagają zarządzać tekstem aplikacji do zlokalizowania i go testować. Te funkcje mają opcje, które pomagają rozwiązywać problemy ze skryptami od prawej do lewej, takimi jak arabski czy hebrajski. Testowanie tekstu do zlokalizowania pozwala dostosować tekst interfejsu i jego układ przed zatwierdzeniem wiadomości w repozytorium źródłowym, aby później wysłać je do tłumaczenia.
Obsługa języków pisanych od prawej do lewej
Jetpack Compose obsługuje układy od prawej do lewej (RTL). Modyfikatory układu i interfejsy API są oparte na pojęciach kierunkowych, takich jak start i end, a nie na kierunkach bezwzględnych, takich jak left i right. Gdy język systemu zmieni się na język zapisywany od prawej do lewej, Compose automatycznie odzwierciedli te układy.
Aby aplikacja rozpoznawała ustawienia regionalne RTL i wywoływała to odbicie lustrzane, musisz wyrazić zgodę na korzystanie z pliku manifestu aplikacji.
Aby włączyć obsługę języków zapisywanych od prawej do lewej:
- Otwórz plik
AndroidManifest.xml. - Dodaj atrybut
android:supportsRtl="true"do elementu<application>:
<manifest ... >
<application
...
android:supportsRtl="true">
</application>
</manifest>
Więcej informacji o tym, jak Compose obsługuje układ tekstu, odbicie lustrzane i niestandardowe konfiguracje RTL, znajdziesz w artykule Praca z językami RTL.
Ręczne ustawianie kierunku tekstu
W Jetpack Compose nie używasz wizualnego okna właściwości, aby wymusić układ lub kierunek tekstu. Compose automatycznie obsługuje odbicie lustrzane od prawej do lewej na podstawie ustawień regionalnych systemu.
Jeśli jednak chcesz ręcznie zastąpić kierunek dla konkretnego elementu tekstowego (np. wyświetlić ciąg znaków od lewej do prawej w układzie od prawej do lewej), możesz przekazać obiekt TextDirection do TextStyle.
Obsługiwane wartości:
TextDirection.Content: (Default): kierunek jest określany na podstawie pierwszego znaku o silnym kierunku.TextDirection.Ltr: wymusza kierunek od lewej do prawej.TextDirection.Rtl: wymusza kierunek od prawej do lewej.
Więcej informacji o stylizowaniu tekstu i konfigurowaniu ręcznych kierunków tekstu w Compose znajdziesz w artykule Stylizowanie tekstu.
Używanie zlokalizowanych ciągów tekstowych w aplikacji
Po dodaniu i przetłumaczeniu ciągów tekstowych za pomocą edytora tłumaczeń pliki res/values/strings.xml zostaną automatycznie zaktualizowane i będzie można używać zlokalizowanych zasobów bezpośrednio w interfejsie.
Aby dowiedzieć się, jak wyświetlać zlokalizowany tekst, natywnie obsługiwać języki zapisywane od prawej do lewej i używać @Preview do testowania różnych języków i pseudojęzyków, zapoznaj się z sekcją dotyczącą ciągów tekstowych w artykule o zasobach w Compose.
Pseudolokalizacje
Pseudolokalizacja to symulowane ustawienia regionalne, które mają odzwierciedlać cechy języków powodujących problemy z interfejsem, układem, kierunkiem od prawej do lewej i inne problemy z tłumaczeniem, gdy aplikacja jest tłumaczona. Pseudolokalizacje zapewniają natychmiastowe i automatyczne tłumaczenia, które są czytelne w języku angielskim we wszystkich wiadomościach, które można zlokalizować. Dzięki temu możesz wykryć w kodzie źródłowym wiadomości, których nie można przetłumaczyć.
Informacje o korzystaniu z pseudolokalizacji znajdziesz w artykule Testowanie aplikacji za pomocą pseudolokalizacji.