This documented is intended as a technical guide for the iOS developers building and personalizing the WhiteLabel version of the AssistAR app.
It is expected that the reader has knowledge about core iOS concepts, like bundle ids, code signing and generation of mobile provisioning profiles.
Requisitos previos
Licencia AssistAR
La aplicación sólo puede ejecutarse con una licencia válida de AssistAR Professional. Por favor, comprueba que tu licencia actual es la correcta o contacta con ventas para actualizarla o solicitar una prueba gratuita.
Token SDK
Obtén un token SDK móvil desde la Management console de TeamViewer (login.teamviewer.com).
ID de paquete de aplicaciones
Es necesario crear un ID de paquete en su Programa para Desarrolladores de Apple. Derechos requeridos: Dominios asociados.
Perfiles de aprovisionamiento
Es necesario crear un perfil de aprovisionamiento de desarrollador y un perfil de aprovisionamiento de distribución (AppStore).
Configuración
El archivo de configuración se encuentra en la ruta BaseAppConfig.xcconfig
Token SDK
Cambia la clave llamada TV_SDK_TOKEN y reemplázala por tu token.
ID del paquete de aplicaciones
Cambia la clave denominada PRODUCT_BUNDLE_IDENTIFIER y cámbiala por tu ID de paquete.
Nombre de la aplicación
Modifica la clave denominada PRODUCT_NAME y reemplázala con el nombre de tu aplicación.
Perfiles de aprovisionamiento
Cambia la configuración en XCode con respecto a la firma de código para que elijas los perfiles de aprovisionamiento que creaste para el desarrollo y para la distribución.
Personalización
Icono de aplicación
Si necesitas cambiar el icono de la aplicación, necesitas generar un paquete de iconos de aplicación iOS utilizando cualquier herramienta. Una vez que tengas el paquete, puedes arrastrarlo y soltarlo en el catálogo de activos de recursos.
Una vez que el paquete se encuentre en los activos, cambia: ASSETCATALOG_COMPILER_APPICON_NAME por el nombre del paquete AppIcon.
Imágenes de bienvenida
Puedes reemplazar las imágenes y el texto de las pantallas de bienvenida, añadiendo las imágenes que necesites al catálogo de recursos, y modificando las siguientes claves en el archivo de configuración:
Imágenes
TV_ONBOARDING_SLIDE_I a TV_ONBOARDING_SLIDE_IV
Textos
TV_ONBOARDING_TEXT_I a TV_ONBOARDING_TEXT_IV
Imagen panorámica
Puedes añadir una imagen de ojo de pez para utilizarla como fondo principal de la aplicación. También puedes desactivar esta opción.
Añade la imagen de ojo de pez de alta resolución (360) al catálogo de activos y, a continuación, especifica el nombre de ese activo en el archivo de configuración con la siguiente clave TV_PANORAMA_NOMBRE_ACTIVO
Logotipo de la pantalla de inicio
Añade una imagen a los activos y edita la configuración con el nombre TV_LAUNCH_SCREEN_ASSET_NAME
Colores
Herramientas de construcción
Proporcionamos la aplicación WhiteLabel con un par de pequeños scripts python para ayudar a cambiar los colores en los archivos de activos y storyboards. No es obligatorio utilizarlo. Puedes añadirlo como parte de tu script de construcción.
Ejemplo de archivo JSON de entrada:
{
"WLText": "FFFFFF",
"WLBackgound": "000000"
}
colores.py
Toma un archivo JSON de definición de colores y reemplaza los colores en la carpeta Assets. Uso:
> python3 colors.py colorMap.json "ApplicationLayer/Assets.xcassets/Whitelabel/"
storyboards.py
Toma un archivo JSON de definición de colores y lo aplica a un guión gráfico determinado. Uso:
> python3 storybaords.py colorMap.json ApplicationLayer/Base.lproj/LaunchScreen.storyboard