Construyendo para iOS

Unity Cloud Build le ayuda a usted automatizar el proceso de construir su Proyecto de Unity para dispositivos iOS.

Este artículo describe los pre-requisitos necesarios para construir su Proyecto para iOS y cómo crear los componentes de soporte para configurar Cloud Build. Los temas cubierto incluyen:

• Unirse al Apple Developer Program
• Crear un certificado iOS y un archivo p12
• Agregar dispositivos a su perfil
• Crear un perfil de aprovisionamiento
• Configurar su app para que construya para iOS

Unirse al Apple Developer Program

Para desarollar apps iOS, usted debe ser miembro del iOS Developer Program. El precio actualmente es de $99 por año, y le permite a usted construir, probar, y eventualmente lanzar sus apps a la Apple App Store.

Nota: Usted debe tener un Mac-basado en Intel corriendo OS X Yosemite (V10.10) o posterior para desarrollar y distribuir apps iOS y Mac.

Para unirse al programa iOS Developer:

1. Inicie sesión en la página Apple Developer Program

   Importante: Utilice el navegador de Safari. Podría encontrarse problemas si utilice los navegadores de Chrome o Firefox.

2. Oprima el botón Enroll.

3. Lea la información en la página What You Need To Enroll y luego oprima el botón Start Your Enrollment.

4. Inicie sesión con su Apple ID, o cree un nuevo Apple ID si usted no tiene uno.

5. Elija si desea inscribirse en un Individual/Sole Proprietor/Single Person Business o como una Company/Organization
   1. Individual/Sole Proprietor/Single Person Business: Seleccione esta opción si usted es una empresa de un solo individuo o propietario único / empresa de una sola persona.
   2. Company/Organization: Seleccione esta opción si es una empresa, una organización sin fines de lucro, una empresa conjunta, una sociedad u organización gubernamental.

6. Ingrese su información de contacto y cualquier información comercial solicitada.

7. Lea el acuerdo de licencia. Si acepta los términos, marque la casilla de aceptación y haga clic en el botón Continue.

8. Compre el programa

   Nota: Usted no puede acceder al Apple Developer Program hasta que su afiliación ha sido aprobada. Apple usualmente toma alrededor de 24 horas para aprovar su afilación.

9. Active el Programa

Después de iniciar sesión en el portal Apple Program Developer, verá una lista con la etiqueta Program Resources en la izquierda. Oprima Certificates, IDs & Profiles para administrar los certificados, identificadores, perfiles y dispositivos que necesita para desarrollar y distribuir aplicaciones.

Provisioning profiles

Un perfil de aprovisionamiento vincula desarrolladores y dispositivos a un equipo de desarrollo autorizado y le permite usar un dispositivo para pruebas. Debe instalar un Development Provisioning Profile en cada dispositivo en el que planea ejecutar el código de su aplicación.

Cada Development Provisioning Profile contiene un conjunto de Development Certificates, Unique Device Identifiers (UDID) y una ID de Aplicación.

Para usar un dispositivo para probar, también debe incluir su Certificado de desarrollo en el perfil. Un solo dispositivo puede contener múltiples perfiles de aprovisionamiento

Componentes de un perfil de aprovisionamiento

Los certificados determinan si su aplicación es solo de desarrollo o una versión candidata para la App Store. Debe usar un Certificado de Producción Ad Hoc para que pueda probar todas las características de su juego (como GameCenter, etc.).

Los identificadores son los ID únicos que usa para identificar su proyecto. Para proyectos básicos, o si este es su primer proyecto de iOS, probablemente quiera crear una ID de aplicación. A menudo, esto es lo mismo que el ID del paquete de su proyecto Unity3D

Sugerencia: Para obtener más información sobre la firma de identidades y certificados, consulte Maintaining Your Signing Identities and Certificates en el sitio web para desarrolladores de Apple .

Los dispositivos son el hardware, como un iPhone, iPad o iPod en el que planea probar su proyecto. Debes recuperar el UDID para cada dispositivo en el que planeas probar su juego. Luego agrega el UDID a la sección Dispositivos en el portal para desarrolladores de iOS.

Nota: Cada año, puede registrar una cantidad fija de dispositivos. La cantidad máxima de dispositivos que puede registrar es de 100 dispositivos por familia de productos por año de membresía. Para obtener más información, consulte Registering Devices Using Your Developer Account en el tema *Maintaining Identifiers, Devices, and Profiles en el Sitio web para desarrolladores de Apple.

Creando un certificado iOS y archivo p12

Cuando usted crea un certificado, usted debe decidir si crear un Certificado de Desarrollo (utilizado solo para pruebas), o un Certificado de Producción, que usted utiliza para distribuir su app vía la App Store.

Sugerencia: Cree un Certificado de Producción. Aunque cualquier tipo de certificado funciona para desarrollar, utilizar un certificado de Producción hace que el proceso de lanzar su aplicación a la tienda Apple más fácil.

Cree un certificado

1. Inicie sesión a su Apple Developer Program.
2. Oprima Member Center > Certificates > Identifiers & Profiles > Certificates.
3. En la columna de la mano izquierda, bajo Certificates, oprima All.
4. En la pantalla etiquetada What type of certificate do you need, , elija el tipo de certificado que va a generar. Por lo general, si recién está comenzando, quiere elegir un App Store and Ad Hoc certificate production certificate.
5. Luego, use el programa Keychain Access en su Mac (abrá su Finder y encuéntrelo en Applications/Utilities) para generar un archivo de Certificate Signing Request (CSR). Siga las instrucciones en el portal de iOS para completar este paso. Anote dónde guarda el archivo CSR, ya que lo necesitará para el siguiente paso.
6. Desde la pantalla Generate your certificate, cargue su archivo CSR (que puede tener la extensión .certSigningRequest). Haga clic en el botón Choose File y seleccione su archivo CSR, y luego oprima en el botón Generate.
7. Para descargar su certificado a su Mac, oprima el botón Download en la pantalla Your Certificate is Ready. Asegúrese de guardar este archivo en un lugar seguro y realizar una copia de seguridad.

Para agregar el certificado a un keychain, ubique el archivo del certificado y oprima en él. Esto abre el programa de Keychain Access. Si aparece una ventana emergente con el mensaje “Do you want to add the certificate to a keychain?”, Elija iniciar sesión y oprima en el botón Add.

Exporte un archivo p12

Para crear aplicaciones usando Unity Cloud Build, debe convertir su archivo de certificado a un archivo p12. Un archivo p12 es un archivo que contiene su clave privada y certificado, y se utiliza para firmar su código. Normalmente, si está desarrollando un proyecto en Xcode nativo, este proceso se maneja para usted detrás de escena.

Para generar un arhivo p12:

1. En su Mac, abrá el Finder y en Applications/Utilities, abrá el programa Keychain Access.

2. En la columna de la mano izquierda, bajo keychains verifique que Login sea seleccionado.

3. En la columna de la mano izquierda, bajo Category verifique que My Certificates esté seleccionado. En el panel principal de Keychain Access, seleccione su certificado.

   Nota: T’ípicamente su certificado está bajo My Certificates. Si usted no lo encuentra ahí, revise bajo Certificates.

4. Del File men, seleccione File > Export Items u oprima con el botón derecho y seleccione Export.

5. Seleccione Personal Information Exchange (.p12) desde el menú desplegable File Format.

   Nota: Si Login bajo Keychains and My Certificates bajo Category no es seleccionado, la opción p12 se vuelve gris.

6. Se le solicitará crear una contraseña para el archivo p12.

   Importante: Grabe la contraseña en algún lugar seguro. Debe proporcionar la contraseña cuando configure construcciones iOS en Unity Cloud Build.

Agregando dispositivos

Apple requiere el UDID para cada dispositivo en el que tiene la intención de instalar su aplicación. Esto solo es necesario para fines de desarrollo. Una vez que su aplicación es aceptada en la App Store, está disponible para que cualquiera pueda descargarla e instalarla; siempre que tengan la versión correcta de iOS y cumplan con los demás requisitos necesarios.

Encontrando sus UDIDs

Puede utilizar iTunes para recuperar el UDID de su dispositivo. Para un recorrido completo del proceso de recuperación, mire WhatsMyUDID.com.

Los pasos básicos son:

1. Abrá iTunes en su Mac.
2. Conecte el dispositivo (iPhone, iPad, etc) al computador.
3. En iTunes seleccione el dispositivo
4. Debería ver una pantalla con el nombre del dispositivo, capacidad, y otros detalles acerca del dispositivo. Para mostrar el UDID, oprima el campo Serial #.
5. Copie y pegue el UDID al documento dónde lo puede recuperar después.
6. Ciere iTunes y desconecte su dispositivo.

Agregue el UDID en el portal de desarrolladores de Apple

Ahora que tiene su dispositivo UDID(s), usted está listo para agregarlos al Portal de Desarrolladores de Apple:

1. Oprima la sección All bajo Devices en la esquina izquierda del iOS Developer Portal.
2. Para agregar un nuevo UDID, oprima el botón Add (+) en la esquina superior derecha
3. Dele al dispositivo un nombre que reconocerá, y copie y pegue el UDID que obtuvo de iTunes en el campo UDID.
4. Oprima Continue.

Repita los pasos para cada uno de sus dispositivos.

Cree un ID de Aplicación

Ahora que ha creado su Certificado iOS, usted puede crear un App ID que sea utilizada para crear un App ID:

1. En la columna de la mano izquierda del Apple Developer Portal, oprima App ID.

2. En el panel de Register iOS App IDs, en la parte superior derecha, oprima el botón Add (+).

3. En el panel de Registering an APP ID, ingrese la siguiente información:
   1. App ID Description: El nombre de su app, sin caracteres especiales.
   2. App ID Suffix: Si tiene la intención de incorporar servicios específicos como Game Center o compras en la aplicación, cree una ID explícita. Si no necesita estos servicios, cree una Wildcard App ID. Una Wildcard App ID le permite volver a usar la ID de aplicación para múltiples proyectos.
   3. App Services: Opcional. Indica si su plan en utilizar cualquiera de los Servicios de la App son proporcionados pro Apple.

   Para más información acerca de registrar un App ID, mire Maintaining Identifiers, Devices, and Profiles.

4. Oprima el botón Continue

5. En la página Confirm your App ID, revise la información que ha proporcionado y luego oprima el botón Submit.

Cree un perfil de aprovisionamiento

El siguiente paso es generar un archivo .mobileprovisionEl archivo .mobileprovision combina su certificado p12, App ID, e identifica el UDIDs de los dispositivos con los cuales está probando su app.

1. En el portal de Desarrolladores de Apple, oprima Certificates, IDs & Profiles.
2. En la columna de la mano izquierda del Portal de Desarrolladores de Apple, bajo Provisioning Profiles, seleccione All.
3. Para agregar un nuevo Provisioning Profile, oprima el botón Add (+) en la esquina superior derecha.
4. Under Development, select the type of provisioning profile to create and click Continue. Note: If you’re just getting started, you should use a Distribution > Ad Hoc certificate, as this allows you to build your game and test it on devices.
5. Seleccione el ID de la aplicacióon que usted quiere utilizar para desarrollo, y oprima el botón Continue.
6. Seleccione uno más certificados de desarrollo, y oprima el botón Continue.
7. Seleccione uno o más dispositivos, y oprima el botón Continue.
8. Ingrese un nombre de perfil, y oprima el botón Generate.
9. Oprima el botón Done.

Descargue el archivo .mobileprovision a su maquina de escritorio.

Configure su app para construir a iOS

Para configurar su iOS Cloud Build, usted necesita los siguientes items:

• Su perfil de aprovisionamiento (.mobileprovision)
• Su archivo.p12
• La contraseña que utilizó para proteger su archivo .p12

Para uso básico de IOS, este proceso debería ser suficiente. Para proyectos que incluye frameworks, usted debe realizar algunas configuraciones adicionales.

Utilizando Frameworks de Xcode

Para agregar frameworks de Xcode manualmente, utilice Xcode Manipulation API. El API es mantenido por el equipo de Unity iOS y el API le permite a usted manejar frameworks externos a Xcode.

Para un ejemplo de un Proyecto de Unity que utilice el API, mire el ejemplo UpdateXcodeProject en BitBucket. Usted puede utilizar el ejemplo para experimentar y aprender.

Uno de los plugins del ejemplo Proyecto es un DLL de manipulación de proyectos Xcode externa. El DLL es el producto de compilación de la fuente disponible en el repositorio Bitbucket de Unity. Una forma preferida de incluir la funcionalidad de manipulación del proyecto Xcode es copiar los archivos del código fuente C# a la carpeta assets/Editor en su Proyecto.

Hay dos maneras que usted puede utilizar la Xcode Manipulation API:

• Utilice el PostProcessBuildAttribute integrado de Unity, que es ejecutado antes del que se ejecute el método Unity Cloud Build Post-Export.
• Utilice el método del Unity Cloud Build Post-Export (requiere acceso a ajustes avanzados).