Base de Conocimientos

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

Todos los ajustes de configuración