Δημιουργία ενός πολυγλωσσικού συστήματος υποστήριξης στην Αντιδραστική Native Apps

Χρήση του συστατικού Trans

Για σύνθετες χορδές με ενσωματωμένα στοιχεία σήμανσης ή αναπαράστασης:

import { Trans } from 'react-i18next';
// In translations: "welcome_html": "Welcome, {user}!"

 Welcome, {user}!

Χειρισμός Πληθωρικών, Φύλων και Πλαίσιο

i18next υποστηρίζει προηγμένους κανόνες πληθυντικού έξω από το πλαίσιο. Καθορίστε τα πλήκτρα με [[LFT:13]] επίθημα ή χρήση [[LFT:14]] πλαίσιο. Παράδειγμα:

{
 "item": "{{count}} item",
 "item_plural": "{{count}} items",
 "item_other": "{{count}} items"
}

Χρήση: επιλέγει αυτόματα τη σωστή φόρμα με βάση την τοπική τοποθεσία. Το φύλο και άλλα πλαίσια μπορούν να αντιμετωπιστούν μέσω της επιλογής .

Δυναμική αλλαγή γλώσσας και επιμονή

Για να επιμείνουμε στην προτίμηση της γλώσσας του χρήστη, αποθηκεύστε την επιλεγμένη γλώσσα σε AsyncStorage (ή [[LFT:2]]react-native-mmkv[[LFT:3]]]]) και φορτώστε την στην εκκίνηση της εφαρμογής. Τροποποίηση της διαμόρφωσης i18n:

import AsyncStorage from '@react-native-async-storage/async-storage';

const languageDetector = {
 type: 'languageDetector',
 async: true,
 detect: async (callback) => {
 const storedLang = await AsyncStorage.getItem('user-language');
 callback(storedLang || 'en');
 },
 init: () => {},
 cacheUserLanguage: async (lng) => {
 await AsyncStorage.setItem('user-language', lng);
 },
};

i18n.use(initReactI18next).use(languageDetector).init({
 fallbackLng: 'en',
 resources,
 interpolation: { escapeValue: false },
});

Τώρα όταν ο χρήστης αλλάζει γλώσσα, η προτίμηση αποθηκεύεται και αυτόματα αποκαθίσταται στην επόμενη έναρξη.

Υποστήριξη δεξιά προς αριστερά (RTL)

Αντιδρήστε Native υποστηρίζει RTL μέσω της ενότητα. Όταν η γλώσσα είναι αραβικά, εβραϊκά, ή περσικά, δύναμη RTL:

import { I18nManager } from 'react-native';

const changeLanguage = async (lng) => {
 await i18n.changeLanguage(lng);
 const isRTL = i18n.dir(lng) === 'rtl';
 I18nManager.forceRTL(isRTL);
 // On Android, you may need to restart the app for full RTL effect
};

Για μια ολοκληρωμένη εμπειρία RTL, χρησιμοποιήστε ] και προσεκτικά. Σκεφτείτε τη χρήση μιας βιβλιοθήκης όπως react-native-restyle για θεματική κατεύθυνση.

Φόρτωση μεταφράσεων από έναν εξυπηρετητή (Over-the-Air)

Για εφαρμογές που πρέπει να προσθέσετε γλώσσες χωρίς ενημερώσεις καταστημάτων εφαρμογών, να φέρετε μετάφραση JSONs από ένα σύστημα υποστήριξης. Χρησιμοποιήστε [[LPT:0]]i18next-http-backend[[LFT:1]] με ένα προσαρμοσμένο σύστημα υποστήριξης για React Native:

import HttpBackend from 'i18next-http-backend';

i18n.use(HttpBackend).init({
 backend: {
 loadPath: 'https://your-api.com/locales/{{lng}}/{{ns}}.json',
 },
 fallbackLng: 'en',
 ns: ['common', 'home'],
 defaultNS: 'common',
});

Συνδυάστε με έναν μηχανισμό έκδοσης για να κατεβάσετε μόνο ενημερωμένα αρχεία.

Επιδόσεις

• Χρήση χωριστού χώρου ονομάτων: Μόνο μεταφράσεις φόρτωσης για την τρέχουσα οθόνη. Η βραδεία φόρτωση μειώνει το αρχικό μέγεθος του πακέτου.
• Αποφύγετε τους επανεντασσόμενους : Το γάντζο βελτιστοποιεί ήδη με την εγγραφή μόνο στις γλωσσικές αλλαγές. Τυλίξτε ακριβά εξαρτήματα με ].
• Προ-compile αρχεία μετάφρασης: Κατά τη διάρκεια της κατασκευής, μετατρέψτε JSON σε minified μορφή.
• Για μεγάλες εφαρμογές, εξετάστε τη χρήση i18next-scanner για να εξαγάγετε αυτόματα τα κλειδιά μεταφράσεων από τη βάση κώδικα σας.

Δοκιμή πολυγλωσσικής λειτουργικότητας

Γράψτε μονάδες δοκιμών για τα αρχεία μεταφράσεών σας: βεβαιωθείτε ότι δεν λείπουν κλειδιά, όλοι οι κάτοχοι του χώρου παρέχονται, και πληθυντικός λειτουργεί σωστά. Χρησιμοποιήστε [[LFT:26]]] με ένα mock i18n παράδειγμα. Για δοκιμές ενσωμάτωσης, προσομοίωση γλωσσικών διακοπτών και ελέγξτε ότι τα συστατικά εμφανίζουν σωστό κείμενο. Επίσης, ελέγξτε RTL απόδοση διάταξης και στις δύο πλατφόρμες.

Οι Βέλτιστες Πρακτικές Ανακεφαλαιώνουν

• Πάντα χρησιμοποιούν τα κλειδιά μεταφράσεων ⁇ ποτέ οι χορδές που έχουν σχέση με τον σκληρό κώδικα.
• Διατηρήστε τις μεταφράσεις οργανωμένες[ από χαρακτηριστικό ή οθόνη (ονοματεπώνυμοι χώροι).
• Χρησιμοποιήστε τις εφεδρικές γλώσσες για να αποτρέψετε την διακοπή των ατελών μεταφράσεων.
• Δοκιμάστε σε πραγματικές συσκευές με διαφορετικές ρυθμίσεις εντοπισμού.
• Σχετικά με τις πολιτισμικές διαφορές πέρα από τη γλώσσα: μορφές ημερομηνίας, έγχρωμες σημασίες, εικόνες.
• Εγχειρίδιο i18n ροή εργασίας σας για μεταφραστές και προγραμματιστές.

Με βιβλιοθήκες όπως [[LFT:0]] react-i18next[[LPT:1]] και [[LFT:4]react-national-localize[[LFT:3]]], μπορείτε να οικοδομήσετε ένα ισχυρό σύστημα που κλιμακώνεται με τη βάση των χρηστών σας. Για περαιτέρω ανάγνωση, ανατρέξτε στην επίσημη [[[LFT:4]] react-i18next τεκμηρίωση[[LPT:5]]], τον [[LFT:6]]]18next κεντρικό οδηγό[[[LFT:7]] και το [[LFT:8] react-native-localize repository[[LT:9]]. Ξεκινήστε το μικρό, το topate, και την εφαρμογή σας θα μιλήσει τη γλώσσα του χρήστη ⁇ λογοτεχνολογικά.