Distribución de versiones con compilaciones hospedadas externamente
Importante
Visual Studio App Center está programado para su retirada el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.
Obtenga más información sobre las escalas de tiempo de soporte técnico y las alternativas.
Puede crear una versión para la aplicación en App Center sin cargar el archivo binario o de compilación. En su lugar, proporcione el vínculo al lugar donde hospeda el archivo. App Center no descargará el archivo. Faltará alguna funcionalidad, pero en su mayoría todo se comporta de la misma manera.
En esta página puede leer cómo crear versiones con compilaciones hospedadas externamente y cuáles son los requisitos y limitaciones.
Empieza a crear una versión en un evaluador o grupo de evaluadores de la misma manera que cualquier versión. A continuación, busque la opción para crear una versión en la que el binario de compilación se hospede externamente:
- Abra la aplicación en el sitio web de App Center y, a continuación, vaya a Distribuir>versiones y elija Nueva versión.
- Elija Especificar la dirección URL de compilación para ir al asistente para crear una versión sin cargar un archivo binario en App Center.
- Escriba la información necesaria.
- Dirección URL HTTPS que apunta al binario que hospeda.
- Número de compilación de la versión.
- Para algunos sistemas operativos: la versión de la versión.
- Elija Siguiente para escribir el resto de la información de la versión. Desde aquí, el flujo es el mismo que para las versiones normales.
- En la pestaña Notas , escriba opcionalmente las notas de la versión de los evaluadores. Elija Siguiente.
- En la pestaña Destinos , seleccione los evaluadores o grupos a los que distribuir la versión. Elija Siguiente.
- En la pestaña Revisar , compruebe los detalles de la versión. Opcionalmente, seleccione no notificar a los usuarios de la versión.
- Por último, elija Distribuir para distribuir la versión. Aparecerán los evaluadores a los que dio acceso y se les notificará en función de la configuración.
Puede crear una versión con un binario hospedado fuera de App Center mediante la interfaz de programación de aplicaciones (API). El primer paso es crear la versión, junto con la dirección URL correcta y los números de versión. Después, puede actualizar opcionalmente la versión con más detalles y distribuirla a los evaluadores.
Si no está familiarizado con la API o las API de App Center en general, comience leyendo la introducción a la API de App Center. Allí puede aprender a autenticarse en la API y a buscar el nombre del propietario y el nombre de la aplicación. Necesitará estos valores a continuación.
Para crear una versión, envíe una POST
solicitud al punto de /v0.1/apps/{owner_name}/{app_name}/releases
conexión. Este punto de conexión toma un cuerpo con los parámetros siguientes:
external_download_url
(obligatorio): la dirección URL HTTPS que apunta al binario que hospeda.build_version
(obligatorio): la versión de la versión.build_number
: número de compilación de la versión.
El {owner_name}
parámetro de la dirección URL es el nombre de la organización o cuenta de usuario que posee la aplicación y {app_name}
es el nombre de la aplicación. Consulte la introducción a la API de App Center para obtener información sobre cómo encontrar estos valores para la aplicación.
Por ejemplo, vamos a crear una nueva versión para la aplicación Calculator
que pertenece a App Center por la MyCorp
organización. El archivo de compilación se hospeda en https://mycorp.example.com/calculator/builds/42
. La versión es 1.12
y el número de compilación es 87324
.
Envíe una POST
solicitud a https://api.appcenter.ms/v0.1/apps/MyCorp/Calculator/releases
con el siguiente json body
:
{
"build_version": "1.12",
"build_number": "87324",
"external_download_url": "https://mycorp.example.com/calculator/builds/42"
}
Establezca el token de API en el X-API-Token
encabezado y establezca el Content-Type
encabezado application/json
en . Una respuesta de ejemplo será (algunos valores omitidos):
{
"app_name": "Calculator",
"is_external_build": true,
"id": 4,
"version": "87324",
"short_version": "1.12",
"download_url": "https://mycorp.example.com/calculator/builds/42",
"install_url": "https://mycorp.example.com/calculator/builds/42",
"destinations": []
}
La dirección URL proporcionada es la dirección URL de descarga y is_external_build
muestra que este es el tipo correcto de versión. La dirección URL de instalación puede ser diferente en función del sistema operativo de la aplicación. La destinations
lista está vacía, lo que significa que aún no hay evaluadores que tengan acceso a la versión. Vamos a distribuir la versión siguiente.
Después de crear la versión, puede distribuirla mediante una llamada a la distribución a un punto de conexión /v0.1/apps/{owner_name}/{app_name}/releases/{release_id}/groups
POST de grupo. O bien, puede usar el punto de conexión similar para distribuir a los evaluadores. Tenga en cuenta que no puede distribuir una versión con una compilación hospedada externamente en almacenes. Consulte Requisitos y limitaciones.
Use el id
valor devuelto al crear la versión para el {release_id}
parámetro en la dirección URL. Busque el id
del grupo al que desea distribuir mediante una llamada al punto de conexión GET de los grupos de distribución. Aquí se distribuye la versión al grupo 86aa9283-4e04-4872-a003-208c267d9388
y se notifica a los evaluadores de la versión:
{
"id": "86aa9283-4e04-4872-a003-208c267d9388",
"notify_testers": true
}
Las versiones hospedadas externamente tienen los siguientes requisitos y limitaciones:
- Debe hospedar el binario detrás de una dirección URL HTTPS segura. App Center no acepta direcciones URL a partir
http://
de , pero solo las que empiezan porhttps://
. - Solo puede distribuir versiones con compilaciones hospedadas externamente a evaluadores y grupos. Las tiendas como Google Play y App Store requieren que los envíes al binario.
- Las actualizaciones en la aplicación no funcionan.
- App Center no puede mostrar el perfil hash MD5, tamaño de archivo ni aprovisionamiento del archivo binario.
- App Center no puede volver a firmar el archivo binario ni administrar automáticamente los dispositivos para aplicaciones iOS.
Las versiones con compilaciones hospedadas externamente se muestran en App Center con un símbolo de cadena en el icono. Al consultar la API para obtener detalles de la versión, las que se muestran is_external_build
como true
son las versiones con compilaciones hospedadas fuera de App Center.
En esta ilustración, la versión 4 es una versión externa, mientras que las otras tres se hospedan en App Center.