\n
$ pod init<\/pre>\n<\/div>\nCela cr\u00e9e un Podfile<\/code> dans notre r\u00e9pertoire racine. Nous allons ouvrir ce fichier dans notre \u00e9diteur de code pr\u00e9f\u00e9r\u00e9 et ajouter une ligne pour qu’il ressemble \u00e0 ceci\u00a0:<\/p>\ntarget 'phraseapp-demo' do\n use_frameworks!\n # Pods for phraseapp-demo\n pod 'PhraseSDK'\nend<\/pre>\nCette modification \u00e9tant enregistr\u00e9e, nous pouvons ex\u00e9cuter ce qui suit depuis notre terminal :<\/p>\n
\n
$ pod install<\/pre>\n<\/div>\nSi tout s’est bien pass\u00e9, nous devrions avoir re\u00e7u une sortie\u00a0indiquant que Phrase a \u00e9t\u00e9 install\u00e9. Apr\u00e8s cela, nous pouvons fermer toutes les fen\u00eatres XCode que nous avons ouvertes et ouvrir le fichier .xcworkspace<\/code> que CocoaPods a ajout\u00e9 \u00e0 la racine de notre projet apr\u00e8s l’installation de Phrase.<\/p>\n<\/span>Configurer Phrase dans notre application iOS<\/span><\/h3>\nLe SDK \u00e9tant install\u00e9, nous allons le connecter \u00e0 notre application. Tout d’abord, jetons un coup d’\u0153il rapide \u00e0 deux m\u00e9thodes principales propos\u00e9es par le SDK Phrase :
\nPhrase.shared.setup(distributionID:environmentSecret:timeout:)<\/code> initialise l’objet singleton Phrase partag\u00e9, en prenant nos informations d\u2019identification et un param\u00e8tre de d\u00e9lai d’attente facultatif.
\nPhrase.shared.updateTranslations(translationResult:)<\/code> met \u00e0 jour manuellement les traductions dans l’application, en r\u00e9cup\u00e9rant les plus r\u00e9centes depuis les serveurs Phrase si une nouvelle version existe. updateTranslations<\/code> prend une fermeture d’\u00e9chappement facultative, translationResult<\/code>, que nous pouvons fournir si nous voulons agir lorsque la requ\u00eate de mise \u00e0 jour est termin\u00e9e.<\/p>\nNous allons ajouter une classe OTATranslations<\/code> qui fournit un l\u00e9ger wrapper autour de PhraseApp<\/code>.<\/p>\nimport PhraseSDK\nclass OTATranslations {\n static let shared = OTATranslations()\n private init() {\n #if DEBUG\n Phrase.shared.debugMode = true\n #endif\n let config: PList? = loadConfig()\n if let config = config {\n #if DEBUG\n let environmentTokenKey: String = \"devToken\"\n #else\n let environmentTokenKey: String = \"prodToken\"\n #endif\n Phrase.shared.setup(\n distributionID: config.getValue(withKey: \"distributionID\"),\n environmentSecret: config.getValue(withKey: environmentTokenKey),\n timeout: config.getValue(withKey: \"timeout\")\n )\n }\n }\n func updateTranslations(onUpdateComplete: (() -> Void)? = nil) {\n do {\n try Phrase.shared.updateTranslations { result in\n switch result {\n case .success(let updated):\n if updated {\n printIfDebug(\"Translations updated successfully\")\n onUpdateComplete?()\n } else {\n printIfDebug(\"No new translations found\")\n }\n case .failure:\n printIfDebug(\"Failure updating translations\")\n }\n }\n } catch {\n printIfDebug(\"Error updating translations: \\(error)\")\n }\n }\n fileprivate func loadConfig() -> PList? {\n do {\n return try PList(pListResource: \"PhraseApp\")\n } catch {\n printIfDebug(\n \"Error loading PhraseApp configuration from plist, \\(error)\")\n }\n return nil\n }\n}<\/pre>\n\ud83d\udca1Pour information \u00bb<\/em> Phrase.shared.debugMode<\/code> est un indicateur qui rend le SDK Phrase plus bavard, en affichant plus de d\u00e9tails dans la console, lorsqu’il est activ\u00e9. Nous l’activons lorsque nous ex\u00e9cutons une version de d\u00e9bogage de notre application.
\n\ud83d\udca1Pour information \u00bb<\/em> La fonction printIfDebug(_:)<\/code> est un helper personnalis\u00e9 qui affiche simplement la cha\u00eene donn\u00e9e dans la console si l’indicateur #DEBUG<\/code> est activ\u00e9.<\/p><\/blockquote>\nNous fournissons un simple objet singleton OTATranslations.shared<\/code> \u00e0 utiliser dans notre application. Notre objet est initialis\u00e9 en tirant les valeurs de configuration de Phrase d’un PhraseApp.plist<\/code> et en les fournissant \u00e0 PhraseApp.setup<\/code>. Pour que cela fonctionne, nous devons cr\u00e9er la classe PhraseApp.plist<\/code> dans notre projet XCode. Nous allons le faire faire maintenant. Cela devrait se pr\u00e9senter de la mani\u00e8re suivante.<\/p>\n![\"Cl\u00e9s](\"https:\/\/phrase.com\/wp-content\/uploads\/2019\/06\/otaios01-phraseapp-plist-keys-values-1024x173.png\")
Assurez-vous que vos cl\u00e9s correspondent \u00e0 celles-ci<\/em><\/p>\nVoici une version texte si vous voulez \u2318-C<\/code>.<\/p>\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-\/\/Apple\/\/DTD PLIST 1.0\/\/EN\" \"http:\/\/www.apple.com\/DTDs\/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n <key>distributionID<\/key>\n <string>your_distribution_id<\/string>\n <key>devToken<\/key>\n <string>your_distribution_development_secret<\/string>\n <key>prodToken<\/key>\n <string>your_distribution_production_secret<\/string>\n <key>timeout<\/key>\n <integer>10<\/integer>\n<\/dict>\n<\/plist><\/pre>\n\u270b\ud83c\udffd Attention \u00bb<\/em> Vous voudrez peut-\u00eatre ajouter votre fichier PhraseApp.plist<\/code> \u00e0 votre .gitignore<\/code> pour prot\u00e9ger vos cl\u00e9s.
\n\ud83d\udca1Pour information \u00bb<\/em> La classe PList<\/code> que nous utilisons pour charger les valeurs de notre fichier .plist<\/code> est une classe utilitaire personnalis\u00e9e.<\/p><\/blockquote>\nLes valeurs pour distributionID<\/code>, devToken<\/code> et prodToken<\/code> peuvent \u00eatre trouv\u00e9es sur la page de la distribution OTA dans la console web Phrase. Nous pouvons naviguer vers l’onglet Overview<\/em> du tableau de bord de notre projet, puis cliquer sur le bouton View distributions<\/em> sous la section Over the Air<\/em>. Cela ouvre la page Over the Air<\/em>. Depuis cette page, nous pouvons trouver et cliquer sur la distribution OTA de notre projet dans la liste Distributions<\/em>. Une fois sur la page de la distribution sp\u00e9cifique, nous pouvons trouver les valeurs Distribution ID<\/em>, Development secret<\/em> et Production secret<\/em> \u00e0 copier-coller dans notre fichier .plist<\/code>. Bien s\u00fbr, nous utilisons \u00ab\u00a0jeton\u00a0\u00bb au lieu de \u00ab\u00a0secret\u00a0\u00bb dans notre .plist<\/code>, mais vous l’avez probablement d\u00e9j\u00e0 compris.<\/p>\n![\"Copier](\"https:\/\/phraseapp.com\/blog\/content\/uploads\/2019\/06\/otaios01-distribution-id-and-keys-on-console-1024x602.png\")
Copiez-collez vos identifiants et jetons secrets<\/em><\/p>\nMaintenant que nous avons connect\u00e9 le SDK Phrase \u00e0 notre classe OTATranslations<\/code>, nous allons l’utiliser dans AppDelegate.swift<\/code>.<\/p>\nimport UIKit\n@UIApplicationMain\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n var window: UIWindow?\n func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {\n OTATranslations.shared.updateTranslations()\n return true\n }\n}<\/pre>\nDans la m\u00e9thode application(_:didFinishLaunchingWithOptions:)<\/code> d’AppDelegate<\/code>, qui s’ex\u00e9cute au d\u00e9marrage de notre application, nous mettons manuellement \u00e0 jour nos traductions over-the-air. Cela r\u00e9cup\u00e8re toutes les nouvelles traductions en arri\u00e8re-plan. Cependant, notre configuration actuelle ne mettra pas \u00e0 jour l’interface utilisateur imm\u00e9diatement. Les mises \u00e0 jour de traduction qui sont r\u00e9cup\u00e9r\u00e9es lors de ce lancement d’application appara\u00eetront \u00e0 l’utilisateur lors du lancement suivant<\/em> de l’application. C’est souvent le comportement attendu : avoir de nouvelles cha\u00eenes de traduction qui apparaissent pendant que l’utilisateur utilise l’application pourrait \u00eatre une exp\u00e9rience utilisateur \u00e9trange et potentiellement d\u00e9stabilisante.<\/p>\n<\/span>Rafra\u00eechir manuellement l’interface utilisateur apr\u00e8s avoir r\u00e9cup\u00e9r\u00e9 de nouvelles traductions<\/span><\/h3>\nCependant, en fonction de nos exigences, nous pourrions avoir besoin de rafra\u00eechir l’interface utilisateur de l’application imm\u00e9diatement apr\u00e8s avoir r\u00e9cup\u00e9r\u00e9 une mise \u00e0 jour de traduction. Nous pouvons le faire en utilisant le param\u00e8tre de fermeture de secours que nous avons fourni dans updateTranslations(onUpdateComplete:)<\/code>.<\/p>\nimport UIKit\n@UIApplicationMain\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n var window: UIWindow?\n func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {\n OTATranslations.shared.updateTranslations() {\n AppDelegate.reloadRootViewController()\n }\n return true\n }\n static func reloadRootViewController() {\n DispatchQueue.main.async {\n let storyboard = UIStoryboard.init(name: \"Main\", bundle: nil)\n let appDelegate = UIApplication.shared.delegate as! AppDelegate\n appDelegate.window?.rootViewController =\n storyboard.instantiateInitialViewController()\n }<\/pre>\nIci, nous fournissons l’argument onUpdateComplete<\/code> \u00e0 updateTranslations<\/code> en tant que fermeture d’\u00e9chappement. Cette fonction de rappel sera appel\u00e9e lorsqu’il y aura de nouvelles traductions r\u00e9cup\u00e9r\u00e9es avec succ\u00e8s. Lorsque cela se produit, nous appelons notre m\u00e9thode personnalis\u00e9e AppDelegate.reloadViewController()<\/code>. Cela rechargera effectivement notre application et montrera \u00e0 l’utilisateur nos traductions les plus r\u00e9centes.<\/p>\n\u270b\ud83c\udffd Attention\u00a0\u00bb<\/em> Soyez vigilant lors du rechargement du contr\u00f4leur de vue racine de l’application. Si l’utilisateur a d\u00e9j\u00e0 commenc\u00e9 \u00e0 faire quelque chose dans votre application, il se peut que son flux soit interrompu (et que ses donn\u00e9es non enregistr\u00e9es soient perdues) lorsque le rechargement se produit. Pour r\u00e9duire la probabilit\u00e9 que cela se produise, vous voudrez peut-\u00eatre utiliser une configuration de timeout<\/code> relativement basse lors de la configuration du SDK PhraseApp<\/code>. De cette fa\u00e7on, si la demande de traduction prend du temps, elle s’annulera simplement et ne d\u00e9clenchera pas le rechargement. Alternativement, et de fa\u00e7on plus fiable, vous pourriez faire appara\u00eetre un indicateur de chargement bloquant pendant la requ\u00eate. Cela emp\u00eacherait l’utilisateur d’interagir avec votre application pendant le chargement de la traduction, \u00e9vitant ainsi la perte de donn\u00e9es mentionn\u00e9e ci-dessus.<\/p><\/blockquote>\n<\/span>La libert\u00e9 des traductions iOS over-the-air avec Phrase<\/span><\/h2>\nNous avons pratiquement termin\u00e9 d’int\u00e9grer les traductions OTA dans notre application. Apr\u00e8s avoir publi\u00e9 cette<\/em> version de notre application sur l’App Store, nous sommes libres d’envoyer des traductions \u00e0 nos utilisateurs sans passer \u00e0 nouveau par l’approbation de l’App Store. Il nous suffit de nous rendre sur notre console web Phrase, et\u00a0:<\/p>\n\n- Mettre \u00e0 jour nos traductions des param\u00e8tres r\u00e9gionaux, puis<\/li>\n
- Cr\u00e9er une nouvelle version pour notre distribution OTA (tout comme nous l’avons fait auparavant), et<\/li>\n
- Publier la version.<\/li>\n<\/ol>\n
![\"Publication](\"https:\/\/phrase.com\/wp-content\/uploads\/2019\/06\/otaios01-publish-release-1024x54.png\")
<\/p>\n
N’oubliez pas de publier votre version apr\u00e8s l’avoir v\u00e9rifi\u00e9e<\/em><\/p>\nC’est aussi simple que \u00e7a. Une fois que nous publions notre version dans la console web Phrase, nos utilisateurs commenceront \u00e0 recevoir les traductions mises \u00e0 jour. Tous les utilisateurs qui ont la version de l’application connect\u00e9e au SDK PhraseApp<\/code> r\u00e9cup\u00e9reront les nouvelles traductions over-the-air. Pas besoin de publier une nouvelle version de l’application, pas besoin d’attendre l’approbation de l’App Store. \u00c7a, c’est la libert\u00e9\u00a0!<\/p>\n