\n
$ pod init<\/pre>\n<\/div>\nEsto crear\u00e1 un Podfile<\/code> en nuestro directorio ra\u00edz. Abramos este archivo en nuestro editor de c\u00f3digo favorito y agreguemos una l\u00ednea para que se vea as\u00ed:<\/p>\ntarget 'phraseapp-demo' do\n use_frameworks!\n # Pods for phraseapp-demo\n pod 'PhraseSDK'\nend<\/pre>\nCon esa edici\u00f3n guardada, podemos ejecutar lo siguiente desde nuestra terminal:<\/p>\n
\n
$ pod install<\/pre>\n<\/div>\nSi todo sali\u00f3 bien, deber\u00edamos haber recibido el mensaje de que se ha instalado Phrase. Despu\u00e9s de eso, podemos cerrar cualquier ventana de XCode que tengamos abierta y abrir el archivo .xcworkspace<\/code> que CocoaPods agreg\u00f3 a la ra\u00edz de nuestro proyecto despu\u00e9s de instalar Phrase.<\/p>\n<\/span>Configurando Phrase en nuestra aplicaci\u00f3n iOS<\/span><\/h3>\nCon el SDK instalado, vamos a conectarlo a nuestra app. Primero, echemos un vistazo r\u00e1pido a dos m\u00e9todos principales que expone el SDK de Phrase.
\nPhrase.shared.setup(distributionID:environmentSecret:timeout:)<\/code> inicializa el objeto singleton compartido de Phrase, utilizando nuestras credenciales y un par\u00e1metro de tiempo de espera opcional.
\nPhrase.shared.updateTranslations(translationResult:)<\/code> actualiza manualmente las traducciones en la aplicaci\u00f3n, obteniendo nuevas desde los servidores de Phrase si existe un nuevo lanzamiento disponible. updateTranslations<\/code> toma un cierre de escape opcional, translationResult<\/code>, que podemos proporcionar si queremos actuar cuando se complete la solicitud de actualizaci\u00f3n.<\/p>\nOk, agreguemos una clase OTATranslations<\/code> que ofrece una capa ligera alrededor 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\udca1Dato \u00bb<\/em> Phrase.shared.debugMode<\/code> es un indicador que hace que el SDK de Phrase sea m\u00e1s expl\u00edcito, mostrando m\u00e1s detalles en la consola cuando est\u00e1 activado. Lo activamos cuando estamos ejecutando una compilaci\u00f3n de depuraci\u00f3n de nuestra aplicaci\u00f3n.
\n\ud83d\udca1\u00a0FYI \u00bb<\/em> La funci\u00f3n printIfDebug(_:)<\/code> es un ayudante personalizado que simplemente muestra en la consola la cadena que se le pasa si el indicador #DEBUG<\/code> est\u00e1 activado.<\/p><\/blockquote>\nProporcionamos un objeto singleton simple, OTATranslations.shared<\/code>, para usar en nuestra aplicaci\u00f3n. Nuestro objeto se inicializa extrayendo valores de configuraci\u00f3n de Phrase de una PhraseApp.plist<\/code> y proporcion\u00e1ndolos a PhraseApp.setup<\/code>. Para que esto funcione, necesitamos crear la clase PhraseApp.plist<\/code> en nuestro proyecto de XCode. Hag\u00e1moslo ahora. Deber\u00eda tener un aspecto similar al siguiente.<\/p>\n![\"Claves](\"https:\/\/phrase.com\/wp-content\/uploads\/2019\/06\/otaios01-phraseapp-plist-keys-values-1024x173.png\")
Aseg\u00farate de que tus claves coincidan con las de aqu\u00ed<\/em><\/p>\nAqu\u00ed hay una versi\u00f3n de texto si quieres \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 Atenci\u00f3n \u00bb<\/em> Quiz\u00e1 quieras agregar el archivo PhraseApp.plist<\/code> a tu .gitignore<\/code> para proteger tus claves secretas.
\n\ud83d\udca1Para tu informaci\u00f3n \u00bb<\/em> La clase PList<\/code> que usamos para cargar los valores de nuestro archivo .plist<\/code> es una clase auxiliar personalizada.<\/p><\/blockquote>\nLos valores de nuestro distributionID<\/code>, devToken<\/code> y prodToken<\/code> se pueden encontrar en la p\u00e1gina de distribuci\u00f3n OTA en la consola web de Phrase. Podemos navegar a la pesta\u00f1a de Resumen<\/em> del tablero de control de nuestro proyecto y hacer clic en el bot\u00f3n Ver distribuciones<\/em> en la secci\u00f3n Over-the-air<\/em>. Esto abre la p\u00e1gina Over-the-air<\/em>, y desde all\u00ed podemos encontrar y hacer clic en la distribuci\u00f3n OTA de nuestro proyecto en la lista Distribuciones<\/em>. Una vez en la p\u00e1gina de la distribuci\u00f3n espec\u00edfica, podemos encontrar los valores de ID de distribuci\u00f3n<\/em>, Secreto de desarrollo<\/em> y Secreto de producci\u00f3n<\/em> para copiarlos y pegarlos en nuestro archivo .plist<\/code>. Por supuesto, estamos usando \u00abtoken\u00bb en lugar de \u00absecret\u00bb en nuestra .plist<\/code>, pero probablemente ya te habr\u00e1s dado cuenta.<\/p>\n![\"Copiar](\"https:\/\/phraseapp.com\/blog\/content\/uploads\/2019\/06\/otaios01-distribution-id-and-keys-on-console-1024x602.png\")
Copiar y pegar tu ID y tus tokens secretos<\/em><\/p>\nOk, ahora que tenemos el SDK de Phrase conectado a nuestra clase OTATranslations<\/code>, hagamos uso de \u00e9l en nuestro 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>\nEn el m\u00e9todo AppDelegate<\/code> de application(_:didFinishLaunchingWithOptions:)<\/code>, que se ejecuta cuando nuestra aplicaci\u00f3n se inicia por primera vez, actualizamos manualmente nuestras traducciones de forma remota. Esto incorpora nuevas traducciones en segundo plano. Sin embargo, nuestra configuraci\u00f3n actual no har\u00e1 que la interfaz de usuario se actualice de inmediato. Las actualizaciones de traducci\u00f3n que se obtienen durante este lanzamiento de la aplicaci\u00f3n aparecer\u00e1n para el usuario durante su pr\u00f3ximo<\/em> lanzamiento de la aplicaci\u00f3n. Este es a menudo el comportamiento que queremos: que nuevas cadenas de traducci\u00f3n aparezcan de repente mientras el usuario est\u00e1 en medio de hacer algo en la aplicaci\u00f3n podr\u00eda ser una experiencia de usuario extra\u00f1a y potencialmente inquietante.<\/p>\n<\/span>Actualizar manualmente la interfaz de usuario despu\u00e9s de importar nuevas traducciones<\/span><\/h3>\nSin embargo, dependiendo de nuestras necesidades, puede que necesitemos actualizar la interfaz de usuario de la app inmediatamente despu\u00e9s de recibir una actualizaci\u00f3n de traducci\u00f3n. Podemos hacer eso utilizando el par\u00e1metro de cierre de callback que proporcionamos en 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>\nAqu\u00ed proporcionamos el argumento onUpdateComplete<\/code> a updateTranslations<\/code> como un cierre de escape. Este closure se llamar\u00e1 cuando haya nuevas traducciones que se hayan obtenido con \u00e9xito. Cuando esto sucede, llamamos a nuestro m\u00e9todo personalizado AppDelegate.reloadViewController()<\/code>. Esto recargar\u00e1 nuestra aplicaci\u00f3n y mostrar\u00e1 al usuario nuestras traducciones m\u00e1s recientes.<\/p>\n\u270b\ud83c\udffd Aviso \u00bb<\/em> Ten cuidado al recargar el controlador de vista ra\u00edz de la aplicaci\u00f3n. Si el usuario ya ha comenzado a hacer algo en tu aplicaci\u00f3n, puede que ese flujo se interrumpa\u00a0\u2013\u00a0y sus datos no guardados se pierdan\u00a0\u2013\u00a0cuando ocurra la recarga. Para reducir las posibilidades de que esto suceda, es posible que desees usar una configuraci\u00f3n de timeout<\/code> relativamente baja al configurar el SDK de PhraseApp<\/code>. De esa manera, si la solicitud de traducci\u00f3n tarda un tiempo, simplemente se cancelar\u00e1 y no activar\u00e1 la recarga. Alternativamente, y de forma m\u00e1s robusta, puedes hacer que aparezca un indicador de carga bloqueante durante la solicitud. Esto impedir\u00eda que el usuario interact\u00fae por completo con tu aplicaci\u00f3n durante la carga de traducci\u00f3n, evitando la p\u00e9rdida de datos mencionada anteriormente.<\/p><\/blockquote>\n<\/span>La libertad de la traducci\u00f3n Over-the-air en iOS con Phrase<\/span><\/h2>\nYa casi hemos terminado de integrar las traducciones OTA en nuestra aplicaci\u00f3n. Despu\u00e9s de publicar esta<\/em> versi\u00f3n de nuestra aplicaci\u00f3n en la App Store, podemos enviar traducciones a nuestros usuarios sin pasar por la aprobaci\u00f3n de la App Store de nuevo. Todo lo que tenemos que hacer es ir a nuestra consola web de Phrase y<\/p>\n\n- Actualiza nuestras traducciones de localizaci\u00f3n y luego<\/li>\n
- crea un nuevo lanzamiento para nuestra distribuci\u00f3n de OTA (igual que hicimos antes), y<\/li>\n
- publica el lanzamiento.<\/li>\n<\/ol>\n
![\"Publicando](\"https:\/\/phrase.com\/wp-content\/uploads\/2019\/06\/otaios01-publish-release-1024x54.png\")
<\/p>\n
No olvides publicar tu lanzamiento despu\u00e9s de revisarlo<\/em><\/p>\nDe verdad que es as\u00ed de simple. Una vez que publiquemos nuestra versi\u00f3n en la consola web de Phrase, nuestros usuarios comenzar\u00e1n a recibir las traducciones actualizadas. Todos los usuarios que tengan la versi\u00f3n de la aplicaci\u00f3n conectada al SDK de PhraseApp<\/code> descargar\u00e1n las nuevas traducciones Over-the-air. No necesitas publicar una nueva versi\u00f3n de tu aplicaci\u00f3n, ni esperar la aprobaci\u00f3n del App Store. Dulce libertad.<\/p>\n