Over the Air (Strings)

Con l'SDK, l'app controlla regolarmente le traduzioni aggiornate e le scarica in background.

Controlla regolarmente le ultime versioni dell'SDK Android, soprattutto considerando gli aggiornamenti.

Se le traduzioni non vengono aggiornate:

Se si utilizza la versione sbagliata di una traduzione, assicurarsi che sia disponibile una versione con le traduzioni più recenti e la versione dell'app corrente e che sia impostato il nomedellaversione per l'app e che si utilizzi il formato <Grave>.<Minore>.<punto>.

Requisiti

Includi l'SDK

Aggiungi un nuovo archivio alla radice build.gradle:

tutti i progetti {
    archivi {
        ...
        maven { url "https://maven.download.phrase.com" }
    }
}

Aggiungi la libreria come dipendenza:

dipendenze {
    implementazione "com.phrase.android:OTA-sdk:3.5.0"
    ...
}

Supporto Jetpack Compose

Per abilitare il supporto Jetpack Compose per le traduzioni OTA, segui i passaggi riportati di seguito:

Configurazione

Inizializzare l'SDK nella classe applicazione e aggiungere l'ID distribuzione e la chiave privata d'ambiente. Le classi ereditate da Application dovrebbero sovrascrivere attachBaseContext per abilitare traduzioni al di fuori del contesto di attività:

MainApplication estende l'applicazione {
  @Override
  public void onCreate() {
      super.onCreate();
      Phrase.setup(this, "DISTRIBUTION_ID", "ENVIRONMENT_TOKEN");
      Phrase.updateTranslations();
  }

  @Override
  protected void attachBaseContext(Context newBase) {
    super.attachBaseContext(Phrase.wrapApplicationContext(newBase));
  }  
}

Iinject l'SDK in ogni attività, ad esempio creando un'attività di base che tutte le altre attività ereditano da:

public class BaseActivity extends AppCompatActivity {
  @NonNull
  @Override
  public AppCompatDelegate getDelegate() {
    restituire Phrase.getDelegate(this, super.getDelegate());
  }
}

Le traduzioni possono essere utilizzate come al solito nei layout:

<TextView android:text="@string/translation_key" />

E codice interno:

TextView text = (TextView) findViewById(R.id.text_id);
text.setText(R.string.translation_key);

Alcune librerie non supportano l'annullamento automatico del contesto e si aspettano una classe specifica. In questo caso l’avvolgimento del contesto nei componenti Jetpack Compose può essere disabilitato con:

Phrase(contextWrapping = false) {
    Text( text = phraseString(R.string.test) )
}

Configurazioni per i livelli di registro:

Modifica lingua

Se non si utilizza la lingua del sistema, è possibile impostare una lingua diversa nel metodo setLocaleCode. Il codice della lingua (impostazioni locali) deve essere presente in una versione.

Phrase.setLocaleCode("fr");
Phrase.updateTranslations();

Versione dell'app personalizzata

L'SDK utilizza la versione dell'app per impostazione predefinita per restituire una versione che corrisponda ai vincoli di versione per la versione min e max. La versione dell'app deve usare il controllo delle versioni semantico altrimenti non viene restituito alcun aggiornamento della traduzione. Se l’app non usa il controllo delle versioni semantico, è possibile sovrascrivere manualmente la versione dell’app utilizzata.

Esempio:

Phrase.setAppVersion("3.2.4");

La versione deve essere impostata prima di chiamare updateTranslations( ).

Timeout impostato

Il timeout predefinito per i download della traduzione è impostato su 10s.

L’impostazione predefinita può essere modificata con:

Phrase.setTimeout(10000); // Timeout in millisecondi

Aggiorna richiamata

Se è richiesta la gestione di aggiornamenti della traduzione riusciti, allegare un gestore della richiamata:

Phrase.updateTranslations(new TranslationsSyncCallback() {
    @Override
    public void onSuccess(traduzioni booleaneModificate) {
    }

    @Override
    vuoto pubblico onFailure() {
    }
});

Gli aggiornamenti della traduzione possono essere attivati anche manualmente. Le traduzioni appena recuperate vengono visualizzate all’Avanti lancio dell’applicazione.

Per rendere immediatamente disponibili le ultime traduzioni, usa il metodo Phrase.applyPendingUpdates(). Questo può essere combinato con l'ascolto degli aggiornamenti della traduzione:

Phrase.updateTranslations(new TranslationsSyncCallback() {
    @Override
    public void onSuccess(traduzioni booleaneModificate) {
      if(translationsChanged) {
         Phrase.applyPendingUpdates()
        // Logica personalizzata per aggiornare l'interfaccia utente
      }
    }

    @Override
    vuoto pubblico onFailure() {
    }
});

L'interfaccia utente non mostra automaticamente le traduzioni e deve essere ricreata.

Configura data center USA

È supportato anche il data center Phrase US. Il data center statunitense può essere configurato chiamando:

Phrase.setHost("https://ota.us.phrase.com/")

Fallback

Se non è possibile raggiungere phrase a causa di una connessione di rete mancante del cliente o di un'interruzione del servizio, l'SDK utilizza le traduzioni in bundle dal file di risorsa. Si consiglia il regolare aggiornamento delle traduzioni in bundle nell'app. L'SDK memorizza anche le traduzioni nella cache locale sul dispositivo. Se tale cache esiste, verrà utilizzata fino all’Avanti aggiornamento della traduzione.

L'SDK utilizza la versione più recente per le traduzioni. Se il versionName per l'app è impostato, verrà utilizzata la versione più recente che soddisfa le restrizioni di versione.

Aggiungi una nuova lingua

Creazione della nuova lingua in phrase e creare di una nuova versione. L'SDK recupera la lingua quando questa è la lingua del dispositivo di un utente. Si consiglia di aggiungere regolarmente un nuovo strings.xml per i file di nuove lingue quando si rilascia una nuova versione dell'app o gli utenti vedranno solo le traduzioni di failback determinate da Android al primo avvio dell'app.

Audit

L'SDK è di origine chiusa e non può essere visualizzato o modificato. Se si tratta di un requisito dell'organizzazione, possono essere forniti audit. Contattaci per maggiori dettagli se richiesto.

Visualizzazione personalizzata Supporto

Le visualizzazioni personalizzate possono essere tradotte utilizzando attributi in stile. Poiché TypedArray non consente la sovrascrittura delle risorse, sono necessarie lievi modifiche nella visualizzazione personalizzata:

Esempio di app

https://github.com/phrase/android-sdk-example

Con l'SDK, l'app controlla regolarmente le traduzioni aggiornate e le scarica in background.

Requisiti

Questa libreria dipende dalla versione 0.18.0 della libreria interna di Flutter.Segui la loro guida per aggiungere il supporto alle localizzazioni all'app.

Installazione

Aggiungi phrase al file pubspec.yaml:

dipendenze:
  phrase: ^2.5.1 
  ...
  intl: ^0.18.0
  flutter_localizations:
    sdk: flutter
  ...

flutter:
  generare: true
  ...

Come nella libreria intl, la generazione di codice viene utilizzata per elaborare i file ARB. Esegui questo comando per aggiornare:

Phrase di esecuzione flutter pub

Usando build_runner:

Orologio flutter pub run build_runner

Utilizzo

Inizializza phrase nel file main.dart:

import 'package:flutter/material.dart';
import 'package:flutter_gen/gen_l10n/app_localizations.dart';
import 'package:flutter_gen/gen_l10n/phrase_localizations.dart';
import 'package:phrase/phrase.dart';

void main() {
  Phrase.setup("[DISTRIBUTION_ID]", "[ENVIRONMENT_ID]");
  runApp(MyApp());
}

La classe MyApp estende StatelessWidget {
  @override
  Costruzione widget (contesto BuildContext) {
    restituire MaterialApp(
      title: "Flutter Demo",
      //..
      localizationsDelegates: PhraseLocalizations.localizationsDelegates,
      supportedLocales: PhraseLocalizations.supportedLocales,
    );
  }
}

Accedi ai messaggi con:

Text(AppLocalizations.of(context)!.helloWorld);

Personalizzazione

Aggiorna comportamento

Le traduzioni OTA vengono aggiornate a ogni avvio dell'app. Per disabilitare questo:

Phrase.setup("[DISTRIBUTION_ID]", "[ENVIRONMENT_ID]", 
    checkForUpdates: false);

Per aggiornare manualmente:

Phrase.updateTranslations(context).then((_) => print("Done!"));

Versione dell'app personalizzata

L'SDK utilizza la versione dell'app per impostazione predefinita per restituire una versione che corrisponda ai vincoli di versione per la versione min e max. La versione dell'app deve usare il controllo delle versioni semantico altrimenti non verrà restituito alcun aggiornamento della traduzione. Se l’app non usa il controllo delle versioni semantico, la versione dell’app può essere sovrascritta manualmente: è possibile sovrascrivere manualmente la versione dell’app:

Phrase.setup("[DISTRIBUTION_ID]", "[ENVIRONMENT_ID]",
    customAppVersion: "1.2.3");

Configura data center USA

È supportato anche il data center Phrase US. Il data center statunitense può essere selezionato passando il parametro API hostname rilevante nella configurazione dell'SDK:

Phrase.setup("[DISTRIBUTION_ID]", "[ENVIRONMENT_ID]", host: PhraseHost.us);

Esempio di app

https://github.com/phrase/flutter_sdk_example

Con l'SDK, l'app controlla regolarmente le traduzioni aggiornate e le scarica in background.

È supportato anche Mac Catalyst.

L'SDK può essere installato manualmente o tramite Swift Package Manager, Carthage o Cocoa Pods.

Se le traduzioni non vengono aggiornate:

Se si utilizza la versione sbagliata di una traduzione, assicurarsi che sia disponibile una versione con le ultime traduzioni e la versione dell'app corrente.

Swift Package Manager

Aggiungi l'URL dell'archivio pubblico (https://gitHub.com/Phrase/ios-sdk/). Xcode gestisce automaticamente il resto dell'installazione.

Cartagine

Aggiungi la seguente riga al tuo Cartfile:

binary "https://raw.githubusercontent.com/phrase/ios-sdk/master/PhraseSDK.json" ~> 3.0.0

Esegui Carthage aggiorna ed aggiungi PhraseApp.framework al tuo progetto come descritto nella documentazione di Cartagine.

Cialde di cacao

Aggiungi la seguente riga al tuo Podfile:

pod "PhraseSDK"

Esegui installazione pod. Se sei nuovo su CocoaPods, consulta la loro documentazione.

Installazione manuale

Segui questi passaggi:

Configurazione

Si consiglia di chiamare entrambe le funzioni all'interno di AppDelegate nel metodo applicationDidFinishLaunchingWithOptions.

Objective-C

Integrare l'SDK nell'applicazione Objective-C:

@import PhraseSDK;

@implementazione AppDelegate

- (BOOL)applicazione:(UIApplicazione *)applicazione doneFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  [[Frase condivisa] setDebugMode:true]; // Facoltativo

  [[Frase condivisa] setupWithDistributionID:@"Il tuo ID distribuzione"
                         environmentSecret:@"Your Environment Secret"];

  // OPPURE:
  //
  // [[phrase shared] ID:@"Il tuo ID distribuzione"
  // environmentSecret:@"Il tuo segreto ambientale"
  //                                   timeout:10];

  // Aggiorna traduzioni utilizzando il blocco di richiamata:
  [[phrase condivisa] updateTranslationsWithCompletionHandler:^(BOOL aggiornato, errore NSError*){
    NSLog(@"Aggiornato: %@", aggiornato ? @"true" : @"false");

    if (error) {
      NSLog(@"Domain: %@ Code: %ld Message: %@", error.domain, (long)error.code, error.localizedDescription);
    } else {
      NSLog(@"No error");
    }

    // Traduci tramite proxy bundle:
    NSString *translation = NSLocalizedString(@"layouts.application.about", @"");
    NSLog (@"NSLocalizedString tramite proxy bundle: %@", traduzione);

    // OPPURE:
    //
    // Traduci usando il metodo di fallback:
    NSString *otherTranslation = [[phrase condivisa]]
                                  localizedStringForKey:@"layouts.application.about" value:NULL table:NULL];
    NSLog(@"Phrase.shared localizedStringForKey: %@", otherTranslation);
  }];

  // OPPURE:
  //
  // [[Frase condivisa]] updateTranslationsWithCompletionHandler:NULL]; // ignora risultati ed errori (sconsigliato)

  // [...] Il tuo altro codice
  
  restituire SÌ;
}

Disabilita scorrimento

Per disabilitare lo swizzling, impostare PhraseSDKMainBundleProxyDisabled su YES nel file Info.plist.

Quando lo swizzling è disabilitato, le traduzioni aggiornate non vengono più visualizzate. La traduzione rimarrà comunque sincronizzata se si chiama updateTranslation ed è possibile accedervi con il metodo Phrase.localizedString().

Gestione della versione dell'app

Per determinare quale versione deve essere restituita, l'SDK richiede una versione semantica dell'app in modo che le traduzioni vengano aggiornate.

L'SDK tenta di ottenere una versione semantica nel modo seguente:

Se CFBundleShortVersionString manca o non può essere creato con una versione semantica insieme a CFBundleVersion, l'SDK lancia il messaggio PhraseSetupError.appVersionNotSemantic.

Disabilita traduzione per tabelle multiple

Per impedire a OTA di tradurre qualsiasi tabella presente nel bundle principale di iOS diversa dalla tabella localizzabile predefinita, impostare la seguente opzione:

Phrase.shared.configuration.ignoreOtherTables = true

Richiami

Allega un gestore di richiamate per gestire gli aggiornamenti della traduzione riusciti:

Phrase.shared.updateTranslation { risultato in
            cambiare il risultato {
            caso .success (let updated):
            caso .failure:
            }
        }

Modalità debug

Se sono necessarie ulteriori informazioni, abilitare la modalità di debug per ottenere una registrazione aggiuntiva del PhraseSDK.framework nella console:

Phrase.shared.configuration.debugMode = true

Imposta il timeout per le richieste

Imposta un timeout per le richieste contro phrase chiamando:

Phrase.shared.configuration.timeout = TimeInterval(20)

Il timeout predefinito è di 10 secondi e le connessioni che richiedono più di 10 secondi verranno chiuse.

Fornisci sostituzione manuale della lingua

Se non si utilizza la lingua del sistema come impostazioni locali, è possibile impostare diverse impostazioni locali nella chiamata init. Il codice delle impostazioni locali deve essere presente in una versione da phrase:

Phrase.shared.configuration.localeOverride = "en-US"

Fallback

Se non è possibile recuperare nuove traduzioni da phrase tramite SDK, vengono utilizzati gli ultimi file di traduzione ricevuti dall'installazione. Se l'app non ha mai ricevuto nuovi file da phrase, usa i file di traduzione compilati dall'app. Ciò evita errori in caso di difficoltà tecniche o errori di rete. Si consiglia di mantenere aggiornati i file di traduzione compilati nell'app con ogni versione.

Audit

L'SDK è di origine chiusa e non può essere visualizzato o modificato. Se si tratta di un requisito dell'organizzazione, possono essere forniti audit. Contattaci per maggiori dettagli se richiesto.

Con l'SDK, l'app controlla regolarmente le traduzioni aggiornate e le scarica in background.

La libreria per traduzioni OTA funziona solo con la libreria react-i18next.

Per installare React Native SDK, segui i passaggi riportati di seguito:

Esempio di file i18next.js

importare i18n da "i18next";
importare { initReactI18next } da "react-i18next";
importare ChainedBackend da "i18next-chained-backend";
importare resourcesToBackend da "i18next-resources-to-backend";
import translationEN from "./locales/en/translation.json";
importare translationRU da "./locales/ru/translation.json";
importare phrase da "react-native-phrase";

const localResources = {
  it: {
    traduzione: translationEN,
  },
  ru: {
    traduzione: translationRU,
  },
};

let phrase = new phrase(
    "YOUR_DISTRIBUTION_ID",
    "YOUR_ENVIRONMENT_ID",
    require('./package.json').version,
    "i18next"
);

const backendPhrase = resourcesToBackend((lingua, spazio dei nomi, richiamata) => {
    phrase.requestTranslation(language)
        .then((remoteResources) => {
            callback (null, remoteResources);
        })
        .catch((errore) => {
            callback (errore, null);
        });
});

const backendFallback = resourcesToBackend(localResources)

i18n
  .use(ChainedBackend)
  .use(initReactI18next)
  .init({
    backend: {
        backends: [backendPhrase, backendFallback]
    },
    debug: true,
    lng: "en",
    fallbackLng: "en",
    interpolazione: {
      escapeValue: false, // non necessario per reagire poiché esegue la escape per impostazione predefinita
    }
  });

Esempio di app

https://github.com/phrase/react_native_sdk_example

La libreria i18next-Phrase-backend implementa un backend di esempio per i18next che recupera le traduzioni dalle versioni OTA.

Per creare una nuova versione, la piattaforma i18next deve essere impostata per la distribuzione ed essere parte di una versione.

Utilizzo

Per inizializzare phrase:

importare i18n da "i18next";
importare { I18nextPhraseBackend } da "@phrase/i18next-backend";

i18n
  .use(I18nextPhraseBackend)
  .init({
    fallbackLng: 'en',
    backend: {
      distribuzione: 'DISTRIBUTION_ID',
      secret: 'YOUR_ENVIRONMENT_SECRET',
      appVersione: '1.0.0',
    }
  });

Caching

La libreria memorizza nella cache le traduzioni e non controllerà la presenza di nuove traduzioni per 5 minuti. Il caching può essere configurato impostando l'opzione cacheExpirationTime nella configurazione del backend a scopo di test.

i18n
  .use(I18nextPhraseBackend)
  .init({
    fallbackLng: 'en',
    backend: {
      distribuzione: 'DISTRIBUTION_ID',
      secret: 'YOUR_ENVIRONMENT_SECRET',
      appVersione: '1.0.0',
      cacheExpirationTime: 60 * 5, // tempo in secondi
    }
  });

Esempio di app

https://github.com/phrase/ota-web-demo

La libreria Phrase-OTA-i18n implementa un backend di esempio per la gemma I18n che recupera le traduzioni dalle versioni OTA. Con la libreria, l'applicazione controlla regolarmente le traduzioni aggiornate e le scarica in background.

La libreria è valida per qualsiasi applicazione Ruby che utilizza la gemma i18n.

Per creare una nuova versione, la piattaforma Rails deve essere impostata per la distribuzione ed essere parte di una versione.

Installazione

Utilizzo

Per generare la configurazione:

bundle exec Rails generano Phrase_ota:install --distribution-ID <DISTRIBUTION_ID> --secret-token <SECRET>

Debug

La gemma ha una configurazione di debug che può essere abilitata nell'inizializzatore impostando:

config.debug = true