Introducción a tvOS

El SDK App Center usa una arquitectura modular para que pueda usar cualquiera o todos los servicios.

Vamos a empezar a configurar el SDK App Center tvOS en la aplicación para usar App Center Analytics y App Center bloqueos.

1. Prerrequisitos

Se deben cumplir los siguientes requisitos para usar App Center SDK:

• El tvOS se configura en Xcode 11 o versiones posteriores en tvOS versión 11 o posterior.
• No está usando ninguna otra biblioteca que proporciona la funcionalidad de informes de bloqueo.

2. Creación de la aplicación en App Center Portal para obtener el secreto de la aplicación

Si ya ha creado la aplicación en App Center portal, puede omitir este paso.

1. Diríjase a appcenter.ms.
2. Regístrese o inicie sesión y pulse el botón azul de la esquina superior derecha del portal que dice Agregar nuevo y seleccione Agregar nueva aplicación en el menú desplegable.
3. Escriba un nombre y una descripción opcional para la aplicación.
4. Seleccione tvOS como sistema operativo y Objective-C/Swift como plataforma.
5. Presione el botón situado en la parte inferior derecha que indica Agregar nueva aplicación.

Una vez que haya creado una aplicación, puede obtener su secreto de aplicación en la página Configuración de App Center Portal. En la esquina superior derecha de la página Configuración, haga clic en los puntos verticales triples y seleccione Copy app secret para obtener el secreto de la aplicación.

3. Agregar los módulos App Center SDK

El SDK App Center para tvOS se puede integrar en la aplicación a través de Cocoapods, Carthage, Swift Administrador de paquetes o agregando manualmente los archivos binarios al proyecto.

3.1 Integración mediante Cocoapods

1. Agregue las siguientes dependencias a para podfile incluir App Center Analytics y App Center bloqueos en la aplicación. Esto extrae los marcos siguientes: AppCenter, AppCenterAnalytics y AppCenterCrashes. En su lugar, puede especificar qué servicios desea usar en la aplicación. Cada servicio tiene su propio subspec y todos se basan en AppCenter . Se extrairá automáticamente.

   # Use the following line to use App Center Analytics and Crashes.
   pod 'AppCenter'
   
   # Use the following lines if you want to specify which service you want to use.
   pod 'AppCenter/Analytics'
   pod 'AppCenter/Crashes'
   

2. Ejecute pod install para instalar el pod recién definido y abra el objeto del .xcworkspace proyecto.

Ahora que ha integrado los marcos de trabajo en la aplicación, es el momento de iniciar el SDK y hacer uso de los App Center servicios.

3.2 Integración a través de Carthage

A continuación se muestran los pasos para integrar el SDK de App Center en el proyecto de Xcode mediante carthage versión 0.30 o posterior, un administrador de dependencias descentralizado que compila las dependencias y proporciona marcos binarios.

1. Agregue las siguientes dependencias a para Cartfile incluir App Center Analytics y App Center bloqueos en la aplicación.

   # Use the following line to get the latest version of App Center
   github "microsoft/appcenter-sdk-apple"
   

   # Use the following line to get the specific version of App Center
   github "microsoft/appcenter-sdk-apple" ~> X.X.X
   

2. Ejecute carthage update --platform tvOS. Esto captura las dependencias en una carpeta Carthage/Checkouts y, a continuación, compila cada marco.

3. Abra la pestaña Configuración general del destino de la aplicación. Arrastre y coloque los archivos AppCenter.framework, AppCenterAnalytics.framework y AppCenterCrashes.framework de la carpeta Carthage/Build/tvOS en el navegador de proyectos de Xcode. AppCenter.framework es necesario para iniciar el SDK. Si no se agrega al proyecto, los demás módulos no funcionarán y la aplicación no se compilará.

4. Aparecerá un cuadro de diálogo y asegúrese de que el destino de la aplicación está activado. Haga clic en Finalizar.

   Nota

   Si usa en la fase de compilación, no debe agregar los SDK de App Center, ya que se envían carthage copy-frameworks como marcos estáticos.

Ahora que ha integrado los marcos en la aplicación, es el momento de iniciar el SDK y hacer uso de los App Center servicios.

3.3 Integración mediante Swift Administrador de paquetes

1. En el menú Xcode, haga clic en File > Swift Packages > Add Package Dependency (Agregar dependencia de paquete).
2. En el cuadro de diálogo que aparece, escriba la dirección URL del repositorio: https://github.com/microsoft/appcenter-sdk-apple.git .
3. En Version (Versión), seleccione Up to Next Major (Hasta siguiente principal) y elija la opción predeterminada.
4. Elija los módulos que necesita en la columna Package Product (Producto del paquete).

Ahora que ha integrado los marcos en la aplicación, es el momento de iniciar el SDK y hacer uso de los App Center servicios.

3.4 Integración mediante la copia de los archivos binarios en el proyecto

A continuación se muestran los pasos para integrar los archivos binarios compilados en el proyecto de Xcode para configurar App Center Analytics y App Center Crashes para la aplicación tvOS.

1. Descargue los App Center SDK proporcionados como un archivo ZIP.

2. Descomprima el archivo y verá una carpeta denominada AppCenter-SDK-Apple que contiene marcos diferentes para cada servicio App Center en cada carpeta de plataforma. El marco llamado es necesario en el proyecto, ya que AppCenter contiene código que se comparte entre los distintos módulos.

3. [Opcional] Cree un subdirectorio para bibliotecas de terceros.

   • Como procedimiento recomendado, las bibliotecas de terceros suelen estar dentro de un subdirectorio (a menudo se denomina Proveedor), por lo que si no tiene el proyecto organizado con un subdirectorio para bibliotecas, cree un subdirectorio Vendor ahora.
   • Cree un grupo denominado Vendor dentro del proyecto de Xcode para imitar la estructura de archivos en el disco.

4. Abra la carpeta AppCenter-SDK-Apple descomprimida en Finder y copie la carpeta en la carpeta del proyecto en la ubicación donde desee. La carpeta contiene marcos en subcarpetas para otras plataformas que App Center SDK admite, por lo que es posible que tenga que eliminar subcarpetas que no necesite.

5. Agregue los marcos del SDK al proyecto en Xcode:

   • Asegúrese de que el navegador de proyectos está visible (⌘+1).
   • Ahora, arrastre y coloque AppCenter.framework, AppCenterAnalytics.framework y AppCenterCrashes.framework desde Finder (los que se encuentran dentro de la carpeta Vendor) en project navigator de Xcode. AppCenter.framework es necesario para iniciar el SDK, asegúrese de que se agrega al proyecto; de lo contrario, los demás módulos no funcionarán y la aplicación no se compilará.
   • Aparecerá un cuadro de diálogo y asegúrese de que el destino de la aplicación está activado. Haga clic en Finalizar.

Ahora que ha integrado los marcos de trabajo en la aplicación, es el momento de iniciar el SDK y hacer uso de los App Center servicios.

4. Iniciar el SDK

Para usar App Center, debe participar en los módulos que desea usar. De forma predeterminada, no se inicia ningún módulo y debe llamar explícitamente a cada uno de ellos al iniciar el SDK.

4.1 Agregar las instrucciones import

Abra el archivo AppDelegate del proyecto y agregue las siguientes instrucciones import:

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Agregar el start:withServices: método

Inserte la siguiente línea en el método didFinishLaunchingWithOptions delegado de la aplicación:

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

Si necesita iniciar los servicios App Center por separado, debe:

1. Configúrelo o inéntelo con el secreto de aplicación.
2. Si se puede llamar al código varias veces, compruebe si el App Center ya está configurado.
3. Inicie los servicios necesarios sin el secreto de aplicación.

[MSACAppCenter configureWithAppSecret:@"{Your App Secret}"];
if ([MSACAppCenter isConfigured]) {
   [MSACAppCenter startService:[MSACAnalytics class]];
   [MSACAppCenter startService:[MSACCrashes class]];
}

AppCenter.configure(withAppSecret: "{Your App Secret}")
if AppCenter.isConfigured {
    AppCenter.startService(Analytics.self)
    AppCenter.startService(Crashes.self)
}

4.3 Reemplazar el marcador de posición por el secreto de aplicación

Asegúrese de reemplazar el {Your App Secret} texto por el valor real de la aplicación. El secreto de la aplicación se puede encontrar en la Tareas iniciales o en la página Configuración del portal App Center aplicación.

La Tareas iniciales contiene el ejemplo de código anterior con el secreto de aplicación en él, puede copiar y pegar el ejemplo completo.

En el ejemplo anterior se muestra cómo usar el método ( para Swift) e incluir tanto start:withServices App Center Analytics como App Center start(withAppSecret:services:) Bloqueos.

Si no desea usar uno de los dos servicios, quite el parámetro correspondiente de la llamada al método anterior.

A menos que especifique cada módulo como un parámetro en el método start, no puede usar ese App Center servicio. Además, la API ( para Swift) solo se puede usar una vez en el ciclo de vida de la aplicación: todas las demás llamadas registrarán una advertencia en la consola y solo estarán disponibles los módulos incluidos en la primera start:withServices start(withAppSecret:services:) llamada.

Por ejemplo, si desea incorporar a App Center Analytics, debe modificar la llamada API ( para start:withServices start(withAppSecret:services:) Swift) de la siguiente manera:

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self])

Excelente, está todo listo para visualizar los datos de Análisis y bloqueos en el portal que el SDK recopila automáticamente.

Consulte la documentación de App Center Analytics y App Center Bloqueos para aprender a personalizar y usar funcionalidades más avanzadas de ambos servicios.