Distribución de App Store y TestFlight

2025-05-06

Importante

Visual Studio App Center se retiró el 31 de marzo de 2025, excepto las características de análisis y diagnóstico, que seguirán siendo compatibles hasta el 30 de junio de 2026. Más información.

Publique actualizaciones de aplicaciones iOS en la App Store y TestFlight con Fastlane en App Center.

Prerrequisitos

La primera versión de una aplicación de iOS debe publicarse a través del portal de App Store Connect.
Compile la aplicación mediante un perfil de aprovisionamiento de App Store y un certificado de producción.
La aplicación debe estar lista para su envío y pasar las directrices de App Store.
Una cuenta activa del Programa para desarrolladores de Apple o tener el identificador de Apple agregado como administrador en la cuenta de App Store Connect de los equipos.
La cuenta conectada debe tener permisos de App Manager para publicar una aplicación.

Para obtener más información, revise la Guía de distribución de aplicaciones de Apple.

Configuración de la conexión entre App Center y App Store Connect

Nota:

Puede conectarse a App Store Connect mediante las credenciales de Apple o una clave de API de App Store Connect. Se recomienda usar la clave de API de Connect para mejorar la estabilidad y establecer niveles de acceso para las claves en el Portal para desarrolladores de Apple. Además, ya no tendrá que renovar la conexión cada 30 días como lo haría con credenciales, 2FA y contraseñas específicas de la aplicación.

Seleccione Almacenes en Distribución.
En el centro de la página, haga clic en el botón Conectar a la Tienda .
Seleccione el tipo de tienda como App Store Connect en el panel que se abre.
Haga clic en Siguiente en la esquina inferior derecha.
Inicie sesión con la clave de API de App Store Connect o con su cuenta de desarrollador de Apple (una actividad única) y haga clic en Conectar.
Al iniciar sesión correctamente, si la cuenta de Apple es miembro de varios equipos, estará disponible una opción para seleccionar el equipo para asociar las compilaciones. Si la cuenta de Apple es miembro de un solo equipo, la selección se configurará automáticamente en el único disponible.
Ahora una lista de aplicaciones para el equipo seleccionado estará disponible para su selección.
Seleccione la aplicación que se va a actualizar.
Las conexiones de la tienda para la aplicación seleccionada se configurarán automáticamente.
- Una conexión de App Store denominada Production.
- Una conexión TestFlight para evaluadores internos denominados Usuarios de App Store Connect.
- Los evaluadores externos agrupan conexiones basadas en los grupos externos creados en la consola de App Store Connect.
La configuración de esta conexión es un proceso único para una aplicación en App Center.

Selección del destino en el menú desplegable para obtener instrucciones de carga

Nota:

Al enviar el archivo de entrega a App Store Connect, App Center tiene como valor predeterminado:

 add_id_info_uses_idfa: false
 export_compliance_uses_encryption: false
 export_compliance_encryption_updated: false

Adición de la autenticación en dos fases

Si la cuenta de Apple tiene habilitada la autenticación en dos fases, App Store Connect requiere una contraseña específica de la aplicación como seguridad. Puede agregar una contraseña específica de la aplicación en Configuración de la cuenta > Cuentas de desarrollador.

Sugerencia

Solo App Store y TestFlight requieren una contraseña específica de la aplicación. Solo los identificadores de Apple con autenticación en dos fases habilitados pueden seleccionar Actualizar contraseña específica de la aplicación.

Pase el cursor sobre un elemento de la lista Cuentas.
Haga clic en los tres puntos verticales del lado derecho de la lista.
Seleccione Actualizar contraseña específica de la aplicación.
Genere una contraseña específica de la aplicación mediante el portal de ID de Apple.
- El nombre es para que recuerde qué servicio o aplicación usa la contraseña específica de la aplicación.
Copie la contraseña específica de la aplicación generada y péguela en el cuadro de diálogo.
Para guardar, haga clic en Actualizar.

Publicación a través de la CLI

Advertencia

Necesita la CLI de App Center 2.7 o posterior para usar esta característica.

Use la CLI como una manera sencilla de integrar la conexión de la tienda de App Center como parte de la configuración de CI/CD, por ejemplo, Jenkins o Go CI.

Deberá establecer una conexión a App Store para poder usar la CLI y compilar un binario compatible.

Puede enumerar los almacenes mediante el comando list como este:

appcenter distribute stores list \
--app {app_owner}/{app_name} \
--output json

Obtendrá un resultado similar al siguiente:

[["Production","apple","production"],["App Store Connect Users","apple","testflight-internal"]]

Y es la columna Store que usaremos en el paso final.

El último paso es publicar la aplicación mediante la ejecución de:

appcenter distribute stores publish \
--file /path/to/file.ipa \
--store Production \
--app {app_owner}/{app_name} \
--release-notes "Some note."

Deberá rellenar los espacios en blanco, como el comando list. En lugar de tener una nota de versión estática, es posible usar en --release-notes-file su lugar. Un archivo de nota de versión es un archivo de texto sin formato codificado con UTF-8.

¿Por qué el identificador de Apple requiere el rol de administrador?

Apple requiere al menos un rol de administrador para crear aplicaciones y enviar versiones y cargar compilaciones, consulte esta tabla que aclara los permisos.

Depuración de una versión con errores

Si se produce un error al publicar un lanzamiento, puede descargar los registros detallados de Fastlane. Estos registros se encuentran en la página de versión detallada haciendo clic en Status > Download Fastlane Logs (Descargar registros de Fastlane).

Error al volver a autenticar

En raras ocasiones cuando se produce un error en la autenticación, puede corregir el problema visitando las secciones Configuración de la cuenta y quitando el id. de Apple. A continuación, visite la página de conexiones de la tienda de la aplicación y seleccione su conexión para establecerla.