Firmar la aplicación

Los sistemas operativos tienen procedimientos de firma ligeramente diferentes, aunque conceptualmente son todos parecidos. Las aplicaciones que se distribuyen para que otros usuarios las utilicen se deben firmar. Aunque ArcGIS AppStudio firmará la aplicación y realizará el proceso de compilación, debe obtener archivos de firma de cada proveedor de sistema operativo para suministrarlos como entradas en AppStudio.

Preparar una aplicación nueva

Antes de firmar y publicar su aplicación, debe otorgársele un Id. de cliente de ArcGIS, una URI de redirección y una cadena de licencia. Aunque se puede crear una aplicación sin Id. de cliente o URI de redirección, ambos son importantes en una aplicación que utiliza servicios de ArcGIS.

Se necesita un Id. de cliente de ArcGIS (también llamado AppID) para inicios de sesión de usuario nominal en todas las aplicaciones. Para obtener un Id. de cliente, vaya a https://developers.arcgis.com, inicie sesión con sus credenciales de desarrollador, haga clic en la flecha desplegable junto a Cuadro de mando y seleccione Nueva aplicación. Una vez registrada, recibirá un Id. de cliente, que puede copiar a su aplicación de AppStudio. Si utiliza ArcGIS AppStudio, también se puede generar un Id. de cliente en Configuración > Licenciamiento haciendo clic en el botón Registrar.

Si su aplicación requiere un inicio de sesión de usuario nominal, también tendrá que proporcionar una URI de redirección. Las URI de redirección representan lugares válidos a los que se puede redirigir a un usuario tras completar un inicio de sesión de OAuth. Para agregar una nueva URI de redirección para su aplicación, vaya a la pestaña Autenticación de su aplicación en https://developers.arcgis.com. Aquí, registre su aplicación si todavía no lo ha hecho y agregue su propia URI de redirección o agregue urn:ietf:wg:oauth:2.0:oob para usar la página de redirección alojada de regreso a su aplicación en ArcGIS Online. La URI urn:ietf:wg:oauth:2.0:oob también se establece automáticamente para todas las aplicaciones creadas y registradas en ArcGIS AppStudio.

Se requiere una cadena de licencia para crear aplicaciones que utilicen ArcGIS Runtime versión 100.x. No se puede crear una aplicación sin una cadena de licencia, que además denota las funciones de la plataforma ArcGIS que la aplicación tiene autorización de realizar. Para obtener información sobre cómo obtener una cadena de licencia, consulte Obtener una licencia para la aplicación.

Firmar la aplicación iOS

Todas las aplicaciones iOS se deben firmar. Las aplicaciones creadas con fines de prueba se deben firmar con un certificado de desarrollador que esté vinculado a la cuenta de desarrollador de Apple y al dispositivo en el que se realizan las pruebas. Un certificado de producción solo está vinculado a la cuenta de desarrollador de Apple.

Antes de ejecutar la herramienta Make del panel lateral de la galería de AppStudio, ya sea en la nube o localmente, asegúrese de que ha proporcionado lo siguiente en la pestaña iOS de Configuración, ubicada en el encabezado Plataformas:

• Id. de paquete: use siempre un nombre de dominio de Internet inverso, por ejemplo, com.nombreempresa.nombreaplicación. El nombre del paquete es un identificador único para la aplicación y es el nombre predeterminado del proceso de la aplicación. Una vez que publique la aplicación, no podrá cambiar el nombre del paquete. Para obtener información adicional, consulte la explicación del Id. de paquete en Prepararse para la distribución de aplicaciones.
• Archivo de aprovisionamiento: indica los dispositivos en los que tiene previsto ejecutar la aplicación.
• Certificado (archivo .p12): certificado para la App Store o para la distribución interna. El archivo se crea en Acceso a Llaveros. Si no proporciona tanto esta información como el Id. de paquete en AppStudio, los archivos de instalación no se generarán. Para obtener más información, consulte ¿Qué es la firma de aplicaciones?

Cuando ejecute la herramienta Make, se le pedirá que introduzca la contraseña del certificado.

Para crear el archivo de certificado requerido para firmar, se deben completar estos pasos una vez para cada desarrollador y se necesita un Mac:

1. Descargue su certificado de desarrollador (por ejemplo, ios_developer.cer) desde el iOS Dev Center.
2. Descargue el perfil de aprovisionamiento móvil (por ejemplo, ios_developer.mobileprovision) desde el iOS Dev Center.
3. Utilice el Buscador para ir a Aplicaciones > Utilidades > Acceso a llaveros.
4. Importe el certificado en Acceso a Llaveros.
5. En Acceso a Llaveros, en la lista Llavero, elija inicio de sesión, y en la lista Categoría, elija Mis certificados. Elija el certificado denominado phone Developer: su nombre y exporte el certificado con la clave privada con una contraseña (por ejemplo, john_doe_private_key.p12).

   Ya se ha creado el archivo de certificado.

6. En AppStudio, vaya a Configuración > Plataformas > iOS.
7. Defina la ruta de perfil de aprovisionamiento.
8. Defina el tipo de distribución de su aplicación. Para obtener más información sobre las opciones, consulte la documentación de Xcode sobre los métodos de distribución.

Nota:

Haga doble clic en el archivo de certificado y el perfil de aprovisionamiento móvil de .p12 para importar los archivos.

Si utiliza AppStudio en macOS, debe definir dos propiedades adicionales para crear aplicaciones iOS en Make de forma local. El contenido de estos campos se puede encontrar en el certificado de desarrollador o de distribución, que se puede ver utilizando el buscador para ir a Aplicaciones > Utilidades > Acceso a llaveros.

Proporcione la unidad organizacional del certificado en el campo Id. de equipo.

Proporcione el nombre común del certificado en el campo Identidad de firma de código.

Firmar la aplicación Android

Para preparar una compilación de una versión de Android, debe generar primero un archivo de almacén de claves de firma. Para obtener información detallada sobre cómo crear este archivo, consulte la documentación de Android.

Antes de ejecutar la herramienta Make, ya sea en la nube o localmente, asegúrese de que ha proporcionado lo siguiente en la pestaña Android de Configuración, ubicada en el encabezado Plataformas:

• Nombre de paquete: use siempre un nombre de dominio de Internet inverso: por ejemplo, com.nombreempresa.nombreaplicación. El nombre del paquete es un identificador único para la aplicación y es el nombre predeterminado del proceso de la aplicación. Una vez que publique la aplicación, no podrá cambiar el nombre del paquete. Si desea obtener información detallada, vea la explicación sobre el nombre del paquete en manifest element, en el SDK de Android.
• Ruta del archivo del almacén de claves: ubicación del archivo del almacén de claves en el equipo de escritorio.
• Alias de clave: nombre de clave creado cuando se creó el almacén de claves.

Si no proporciona esta información, los archivos de instalación se crearán, pero no estarán firmados. Los archivos sin firmar se pueden instalar con fines de prueba, pero no se pueden enviar a la tienda de Google Play o Amazon Appstore.

Cuando ejecute la herramienta Make, se le pedirá que introduzca la contraseña del almacén de claves y de las claves.

Para crear un keystore, se deben completar estos pasos una vez para cada desarrollador:

1. Descargue e instale el Java Development Kit (JDK) desde https://www.oracle.com/technetwork/java/javase/downloads/index.html.
2. Cree una variable de entorno denominada JAVA_HOME en su equipo de escritorio: https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/index.html.
3. Agregue la ruta de carpeta bin JDK a la variable de entorno PATH.
4. En una ventana de comando, use lo siguiente para crear la clave: keytool -genkey -v -keystore [keystore_name].keystore -alias [alias_name] -keyalg RSA -keysize 2048 -validity 10000, donde keystore_name es el nombre elegido para el archivo keystore resultante y alias_name es el nombre elegido como alias.
5. Escriba una contraseña de keystore y confirme.
6. Introduzca la información adicional y confirme.
7. Introduzca una contraseña de clave. Esta contraseña puede ser única. Si lo prefiere, pulse Intro para usar una contraseña que coincida con la de keystore.

   El archivo keystore se creará en la carpeta en la que se ha ejecutado este comando.

Firmar la aplicación macOS

De forma similar a Android, si no proporciona un certificado al solicitar los archivos de instalación de macOS, estos se crearán, pero no estarán firmados. Los archivos sin firmar se pueden instalar con fines de prueba, pero no se pueden enviar a la Mac Store. Los pasos siguientes son similares a los de iOS, solo que no se necesita ningún perfil de aprovisionamiento para macOS. Para obtener más información, consulte ¿Qué es la firma de aplicaciones?

Antes de ejecutar la herramienta Make, ya sea en la nube o localmente, asegúrese de que ha proporcionado lo siguiente en la pestaña macOS de Configuración, ubicada en el encabezado Plataformas:

• Id. de paquete: use siempre un nombre de dominio de Internet inverso, por ejemplo, com.nombreempresa.nombreaplicación. El nombre del paquete es un identificador único para la aplicación y es el nombre predeterminado del proceso de la aplicación. Una vez que publique la aplicación, no podrá cambiar el nombre del paquete. Para obtener información adicional, consulte la explicación del Id. de paquete en Prepararse para la distribución de aplicaciones.
• Certificado (archivo .p12): certificado para la App Store o para la distribución interna. El archivo se crea en Acceso a Llaveros. Si no proporciona tanto esta información como el Id. de paquete en AppStudio, los archivos de instalación no se generarán. Para obtener más información, consulte ¿Qué es la firma de aplicaciones?

Cuando ejecute la herramienta Make, se le pedirá que introduzca la contraseña del certificado.

Para crear el archivo de certificado requerido para firmar una aplicación de macOS, siga los mismos pasos que se describieron arriba para las aplicaciones de iOS.

Firmar la aplicación Windows

De forma similar a Android, si no proporciona un certificado al solicitar los archivos de instalación de Windows, estos se crearán, pero no estarán firmados.

Antes de ejecutar la herramienta Make, ya sea en la nube o localmente, asegúrese de que ha proporcionado un archivo de certificado en la pestaña Windows de Configuración, ubicada en el encabezado Plataformas. Este certificado (archivo .p12 o .pfx) está destinado a la Windows Store o para la distribución interna. Consulte Crear un certificado para la firma de paquetes en la documentación para desarrolladores de Microsoft para obtener más información.