Publicación de una aplicación Mac Catalyst para su distribución fuera de Mac App Store

Una alternativa a la distribución de aplicaciones Mac Catalyst a través de Mac App Store es distribuirlas fuera de Mac App Store. Con este enfoque, tu aplicación Mac Catalyst se puede hospedar en una ubicación de tu elección para su descarga. Los miembros del programa para desarrolladores de Apple y Apple Developer Enterprise Program pueden usar este enfoque de distribución.

La distribución de una aplicación Mac Catalyst requiere que la aplicación se aprovisione mediante un perfil de aprovisionamiento. Los perfiles de aprovisionamiento son archivos que contienen información sobre la firma de código, así como la identidad de la aplicación y su mecanismo de distribución previsto.

Para distribuir una aplicación Mac Catalyst de .NET Multi-platform App UI (.NET MAUI) fuera de Mac App Store, deberás crear un perfil de aprovisionamiento de distribución específico para ella. Este perfil permite que la aplicación se firme digitalmente para su publicación de modo que se pueda instalar en equipos Mac. Un perfil de aprovisionamiento de distribución contiene un identificador de aplicación y un certificado de aplicación de identificador de desarrollador. Deberás crear un certificado de aplicación de identificador de desarrollador para identificarte a ti mismo o tu organización, si aún no tienes uno. Además, deberás crear un certificado de instalador de identificador de desarrollador para firmar el paquete del instalador de la aplicación.

El proceso para aprovisionar una aplicación .NET MAUI Mac Catalyst para distribución fuera de Mac App Store es el siguiente:

1. Crea dos solicitudes de firma de certificados. Para obtener más información, consulta Creación de una solicitud de firma de certificado.
2. Crea un certificado de aplicación de identificador de desarrollador. Para obtener más información, consulta Creación de un certificado de aplicación de identificador de desarrollador.
3. Crea un certificado de instalador de identificador de desarrollador. Para obtener más información, consulta Creación de un certificado de instalador de identificador de desarrollador.
4. Crea un identificador de aplicación. Para obtener más información, consulta Creación de un identificador de aplicación.
5. Crear un perfil de aprovisionamiento. Para obtener más información, consulta Creación de un perfil de aprovisionamiento.
6. Descarga tu perfil de aprovisionamiento. Para obtener más información, consulta Descargar tu perfil de aprovisionamiento en Xcode.

Después, una vez completado el aprovisionamiento, debes preparar tu aplicación para publicarla, publicarla y certificarla con el siguiente proceso:

1. Opcionalmente, agrega derechos a la aplicación. Para obtener más información, consulta Agregar derechos.
2. Actualiza el archivo Info.plist de la aplicación. Para obtener más información, consulta Actualización de Info.plist.
3. Deshabilita la verificación de firma de código para la aplicación. Para obtener más información, consulta Deshabilitación de la comprobación de firmas de código.
4. Publica la aplicación mediante la línea de comandos. Para obtener más información, consulta Publicación mediante la línea de comandos.
5. Certifica tu aplicación. Para obtener más información, consulta Certificación de tu aplicación.

Creación de una solicitud de firma de certificado

Antes de crear un certificado de distribución, primero deberás crear una solicitud de firma de certificado (CSR) en Acceso a cadena de claves en un equipo Mac:

1. En el equipo Mac, inicie Acceso a llaves.

2. En el menú Acceso a Llaveros, selecciona los elementos de menú Acceso a Llaveros > Asistente para Certificados > Solicitar un certificado de una autoridad de certificación....

3. En el cuadro de diálogo Asistente para Certificados, introduce una dirección de correo electrónico en el campo Dirección de correo electrónico de usuario.

4. En el cuadro de diálogo Asistente para Certificados, introduce un nombre para la llave en el campo Nombre común.

5. En el cuadro de diálogo Asistente para certificados, deja vacío el campo Dirección de correo electrónico de CA.

6. En el cuadro de diálogo Asistente para certificados, elige el botón de selección Guardado en disco y selecciona Continuar:

   

7. Guarda la solicitud de firma de certificado en una ubicación conocida.

8. En el cuadro de diálogo Asistente para certificados, selecciona el botón Listo.

9. Cierra Acceso a Llaveros.

Repite este proceso para crear una segunda solicitud de firma de certificado. La primera CSR se usará para crear un certificado de aplicación de identificador de desarrollador. La segunda se usará para crear un certificado de instalador de identificador de desarrollador.

Creación de un certificado de aplicación de identificador de desarrollador

La CSR permite generar un certificado de identificador de desarrollador, que confirma tu identidad. El certificado de identificador de desarrollador debe crearse con el ID de Apple para tu cuenta de desarrollador de Apple:

1. En un explorador web, inicia sesión en tu cuenta de desarrollador de Apple.

2. En la cuenta de desarrollador de Apple, selecciona la pestaña Certificates, IDs Profiles.

3. En la página Certificates, Identifiers & Profiles, haz clic en el botón + para crear un nuevo certificado.

4. En la página Create a New Certificate, selecciona el botón de radio Developer ID Application antes de seleccionar el botón Continue:

   

5. En la página Create a New Certificate, selecciona el botón de radio G2 Sub-CA y luego selecciona Choose File:

   

6. En el cuadro de diálogo Choose Files to Upload, selecciona el primer archivo de solicitud de certificado que creaste anteriormente (un archivo con una extensión de archivo .certSigningRequest) y luego selecciona Upload.

7. En la página Create a New Certificate, selecciona el botón Continue:

   

8. En la página Descargar el certificado, selecciona el botón Descargar:

   

   El archivo de certificado (un archivo con una extensión .cer) se descargará en la ubicación elegida.

9. En el equipo Mac, haz doble clic en el archivo de certificado descargado para instalar el certificado en el llavero. El certificado aparece en la categoría My Certificates en Keychain Access y comienza con Developer ID Application:

   

   Nota:

   Anota el nombre completo del certificado en Acceso a Llaveros. Será necesario al firmar la aplicación.

Creación de un certificado de instalador de identificador de desarrollador

La CSR permite generar un certificado de instalador de identificador de desarrollador, que es necesario para firmar el paquete del instalador de la aplicación. El certificado de instalador debe crearse con el ID de Apple para la cuenta de desarrollador de Apple:

1. En la cuenta de desarrollador de Apple, selecciona la pestaña Certificates, IDs Profiles.

2. En la página Certificates, Identifiers & Profiles, haz clic en el botón + para crear un nuevo certificado.

3. En la página Create a New Certificate, selecciona el botón de radio Developer ID Installer antes de seleccionar el botón Continue:

   

4. En la página Create a New Certificate, selecciona el botón de radio G2 Sub-CA y luego selecciona Choose File:

   

5. En el cuadro de diálogo Choose Files to Upload, selecciona el segundo archivo de solicitud de certificado que creaste anteriormente (un archivo con una extensión de archivo .certSigningRequest) y luego selecciona Upload.

6. En la página Create a New Certificate, selecciona el botón Continue:

   

7. En la página Descargar el certificado, selecciona el botón Descargar:

   

   El archivo de certificado (un archivo con una extensión .cer) se descargará en la ubicación elegida.

8. En el equipo Mac, haz doble clic en el archivo de certificado descargado para instalar el certificado en el llavero. El certificado aparece en la categoría My Certificates en Keychain Access y comienza con Developer ID Installer:

   

   Nota:

   Anota el nombre completo del certificado en Acceso a Llaveros. Será necesario al firmar la aplicación.

Creación de un perfil de distribución

Un perfil de aprovisionamiento de distribución permite que la aplicación .NET MAUI Mac Catalyst esté firmada digitalmente para su lanzamiento, de modo que se pueda instalar en otro equipo Mac. Un perfil de aprovisionamiento para la distribución fuera de Mac App Store contiene un identificador de aplicación y un certificado de aplicación de identificador de desarrollador.

Creación de un id. de aplicación

Se requiere un identificador de aplicación para identificar la aplicación que distribuyes. Un identificador de aplicación es similar a una cadena DNS inversa que identifica de forma única una aplicación y debe ser idéntica al identificador del lote de la aplicación. Puedes usar el mismo identificador de aplicación que usaste al implementar la aplicación en un dispositivo para realizar pruebas.

Hay dos tipos de identificadores de aplicación:

• Carácter comodín. Un identificador de aplicación comodín permite usar un identificador de aplicación para que coincida con varias aplicaciones, y normalmente, adopta el formato com.domainname.*. Puedes usar un identificador de aplicación comodín para distribuir varias aplicaciones y debes usarlo para las aplicaciones que no habilitan las funciones específicas de la aplicación.
• Explícita. Un identificador de aplicación explícito es único para una sola aplicación y normalmente adopta el formato com.domainname.myid. Un identificador de aplicación explícito permite la distribución de una aplicación, con un identificador de la agrupación coincidente. Los identificadores de aplicación explícitos se usan normalmente para las aplicaciones que habilitan funciones específicas de la aplicación, como Apple Pay o Game Center. Para obtener más información, consulta Funcionalidades.

Para crear un nuevo identificador de aplicación:

1. En tu cuenta de desarrollador de Apple, ve a Certificates, IDs & Profiles.

2. En la página Certificates, IDs & Profiles, selecciona la pestaña Identifiers.

3. En la página Identifiers, selecciona el botón + para crear un nuevo identificador de aplicación.

4. En la página Register a new identifier, selecciona el botón de radio App IDs antes de seleccionar el botón Continue:

   

5. En la página Register a new identifier, selecciona App antes de seleccionar el botón Continue:

   

6. En la página Registro de un id. de aplicación, introduce una descripción y selecciona el botón de radio Explícito o el id. de paquete de caracteres comodín. Después, introduce el id. de agrupación de tu aplicación en formato DS inverso:

   

   Importante

   El identificador de agrupación que escribas debe corresponder al identificador de agrupación del archivo Info.plist del proyecto de aplicación.

   El identificador de agrupación de una aplicación .NET MAUI se almacena en el archivo de proyecto como la propiedad Identificador de aplicación. En Visual Studio, en Explorador de soluciones, haz clic con el botón derecho en el proyecto de tu aplicación .NET MAUI y selecciona Propiedades. Después, accede a la pestaña Configuración de MAUI Compartido> General. El identificador de aplicación muestra el identificador de agrupación.

   Cuando se actualiza el valor del campo Id. de aplicación, el valor de Identificador de agrupación en el archivo Info.plist se actualizará automáticamente.

7. En la página Registro de un id. de aplicación, selecciona las capacidades que usa la aplicación. Cualquier capacidad debe configurarse tanto en esta página como en el archivo Entitlements.plist del proyecto de tu aplicación. Para ver más información, consulta Funcionalidades y Derechos.

8. En la página Register an App ID, selecciona el botón Continue.

9. En la página Confirm your App ID, selecciona el botón Register.

Creación de un perfil de aprovisionamiento

Una vez creado el identificador de aplicación, debes crear un perfil de aprovisionamiento de distribución. Este perfil permite que la aplicación se firme digitalmente para su publicación de modo que se pueda instalar en equipos Mac.

Para crear un perfil de aprovisionamiento para la distribución fuera de Mac App Store:

1. En la página Certificates, Identifiers & Profiles de la cuenta de desarrollador de Apple, selecciona la pestaña Profiles.

2. En la pestaña Perfiles, haz clic en el botón + para crear un nuevo perfil.

3. En la página Register a New Provisioning Profile, selecciona el botón de radio Developer ID antes de hacer clic en el botón Continuar:

   

4. En la página Generate a Provisioning Profile, selecciona el botón de radio Mac Catalyst. Luego, en la lista desplegable App ID, selecciona el identificador de aplicación que creaste anteriormente antes de hacer clic en el botón Continue:

   

5. En la página Generate a Provisioning Profile, selecciona el botón de radio que corresponde con tu certificado de distribución antes de hacer clic en el botón Continuar:

   

6. En la página Generate a Provisioning Profile, introduce un nombre para el perfil de aprovisionamiento antes de hacer clic en el botón Generate:

   

   Nota:

   Anota el nombre del perfil de aprovisionamiento, ya que será necesario cuando firmes tu aplicación.

7. En la página Generate a Provisioning Profile, haz clic opcionalmente en el botón Download para descargar tu perfil de aprovisionamiento.

   Nota:

   No es necesario descargar el perfil de aprovisionamiento ahora. En cambio, lo harás en Xcode.

Descarga del perfil de aprovisionamiento en Xcode

Después de crear un perfil de aprovisionamiento en la cuenta de desarrollador de Apple, Xcode puede descargarlo para que esté disponible para firmar la aplicación:

1. En el equipo Mac, inicia Xcode.

2. En Xcode, selecciona el elemento de menú Xcode > Preferencias....

3. En el cuadro de diálogo Preferencias, selecciona la pestaña Cuentas.

4. En la pestaña Cuentas, haz clic en el botón + para agregar la cuenta de desarrollador de Apple a Xcode:

   

5. En el menú emergente de tipo de cuenta, selecciona ID de Apple y después haz clic en el botón Continuar:

   

6. En el menú emergente de inicio de sesión, escribe el ID de Apple y haz clic en el botón Siguiente.

7. En el menú emergente de inicio de sesión, escribe la contraseña de ID de Apple y haz clic en el botón Siguiente :

   

8. En la pestaña Cuentas, haz clic en el botón Administrar certificados... para asegurarte de que se ha descargado el certificado de distribución.

9. En la pestaña Cuentas, haz clic en el botónDescargar perfiles manuales para descargar los perfiles de aprovisionamiento:

   

10. Espere a que se complete la descarga y cierra Xcode.

Adición de derechos

El espacio aislado de aplicaciones de Apple restringe el acceso a los recursos del sistema y a los datos de usuario en aplicaciones Mac, para contener los daños si una aplicación se pone en peligro. Opcionalmente, se puede habilitar para aplicaciones Mac Catalyst que se distribuyen fuera de Mac App Store.

Para ello, agrega un archivo Entitlements.plist a la carpeta Platforms/MacCatalyst del proyecto de aplicación .NET MAUI:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>com.apple.security.app-sandbox</key>
    <true/>
  </dict>
</plist>

El derecho del espacio aislado de la aplicación se define mediante la clave com.apple.security.app-sandbox, de tipo boolean. Para obtener más información sobre el espacio aislado de aplicaciones, consulta Protecting user data with App Sandbox en developer.apple.com. Para obtener más información sobre el derecho del espacio aislado de aplicaciones, consulta App Sandbox Entitlement.

Si la aplicación abre conexiones de red salientes, también deberás agregar la clave com.apple.security.network.client clave, de tipo boolean, al archivo Entitlements.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>com.apple.security.app-sandbox</key>
    <true/>
    <key>com.apple.security.network.client</key>
    <true/>
  </dict>
</plist>

Para obtener más información sobre el derecho de las conexiones de red salientes, consulta com.apple.security.network.client en developer.apple.com.

Actualización de Info.plist

Antes de publicar la aplicación, debes actualizar su archivo Info.plist con información adicional.

Especificación de la expresión de interfaz de usuario

Una aplicación Mac Catalyst se puede ejecutar en la expresión de la interfaz de usuario de iPad o Mac:

• La expresión de la interfaz de usuario de iPad indica a macOS que escale la interfaz de usuario de la aplicación para que coincida con el entorno de visualización de Mac, a la vez que se conserva la apariencia del iPad.
• La expresión de interfaz de usuario de Mac no escala la interfaz de usuario de la aplicación para que coincida con el entorno de visualización de Mac. Algunos controles cambian de tamaño y apariencia e interactuar con ellos idéntico a interactuar con los controles AppKit.

De forma predeterminada, las aplicaciones de .NET MAUI Mac Catalyst usan la expresión de interfaz de usuario de iPad. Si este es tu comportamiento deseado, asegúrate de que el archivo Info.plist de la aplicación solo especifica 2 como valor de la clave UIDeviceFamily:

<key>UIDeviceFamily</key>
<array>
  <integer>2</integer>
</array>

Para adoptar la expresión de la interfaz de usuario de Mac, actualiza el archivo Info.plist para especificar 6 como el valor de la clave UIDeviceFamily:

<key>UIDeviceFamily</key>
<array>
  <integer>6</integer>
</array>

Para obtener más información sobre las expresiones de interfaz de usuario de Mac Catalyst, consulta Especificación de la expresión de interfaz de usuario para la aplicación Mac Catalyst.

Establecimiento del idioma y la región predeterminados de la aplicación

Establece la clave CFBundleDevelopmentRegion del archivo Info.plistde la aplicación en un string que represente la región de desarrollo nativo de localización:

<key>CFBundleDevelopmentRegion</key>
<string>en</string>

El valor de la clave debe ser un designador de idioma, con un designador de región opcional. Para obtener más información, consulta CFBundleDevelopmentRegion en developer.apple.com.

Establecimiento de la clave de copyright

Establece la clave NSHumanReadableCopyright del archivo Info-plist en un string que represente el aviso de copyright legible para la aplicación:

<key>NSHumanReadableCopyright</key>
<string>MyMauiApp © 2023</string>

Para obtener más información, consulta NSHumanReadableCopyright en developer.apple.com.

Declaración del uso del cifrado de la aplicación

Si la aplicación usa cifrado y planeas distribuirla fuera del Estados Unidos o Canadá, está sujeta a los requisitos de cumplimiento de exportación de EE. UU. Puedes proporcionar información sobre el uso del cifrado de la aplicación en su archivo Info.plist.

Esto se logra agregando la clave ITSAppUsesNonExemptEncryption a tu info.plist de la aplicación con un valor boolean que indica si la aplicación usa cifrado:

<key>ITSAppUsesNonExemptEncryption</key>
<false/>

Para obtener más información, consulta Complying with Encryption Export Regulations en developer.apple.com.

Deshabilitación de la verificación de firma de código

Actualmente, al intentar publicar una aplicación .NET MAUI Mac Catalyst para su distribución fuera de Mac App Store, siempre que hayas cumplido los requisitos de aprovisionamiento, recibirás un error codesign al salir con el código 3:

/usr/local/share/dotnet/packs/Microsoft.MacCatalyst.Sdk/16.2.1040/tools/msbuild/iOS/Xamarin.Shared.targets(1930,3): error MSB6006: "codesign" exited with code 3. [/Users/davidbritch/Projects/MyMauiApp/MyMauiApp/MyMauiApp.csproj::TargetFramework=net8.0-maccatalyst]

Aunque codesign se realiza correctamente al firmar tu aplicación, el destino _CodesignVerify no puede verificar la firma del código:

test-requirement: code failed to satisfy specified code requirement(s)

Debido a este error, no se produce un archivo .pkg.

Por lo tanto, actualmente es necesario agregar el siguiente destino de compilación al final del archivo de proyecto para deshabilitar la verificación de la firma de código:

<Project Sdk="Microsoft.NET.Sdk">
  ...
  <Target Name="_SkipCodesignVerify" BeforeTargets="_CodesignVerify" AfterTargets="_CodesignAppBundle">  
    <PropertyGroup>    
      <_RequireCodeSigning>false</_RequireCodeSigning>  
    </PropertyGroup>
  </Target>
</Project>

Publicar mediante la línea de comandos

Para publicar tu aplicación Mac Catalyst desde la línea de comandos de un equipo Mac, abre un terminal y ve a la carpeta del proyecto de la aplicación .NET MAUI. Ejecuta el comando dotnet publish con los parámetros siguientes:

Se pueden especificar parámetros de compilación adicionales en la línea de comandos, si no se proporcionan en <PropertyGroup> en tu archivo de proyecto. En la tabla siguiente se enumeran algunos de los parámetros comunes:

Para obtener una lista completa de las propiedades de compilación, consulta Project file properties.

Por ejemplo, usa el siguiente comando para compilar y firmar un .pkg en un equipo Mac, para su distribución fuera de Mac App Store:

dotnet publish -f net8.0-maccatalyst -c Release -p:MtouchLink=SdkOnly -p:CreatePackage=true -p:EnableCodeSigning=true -p:EnablePackageSigning=true -p:CodesignKey="Developer ID Application: John Smith (AY2GDE9QM7)" -p:CodesignProvision="MyMauiApp (Non-App Store)" -p:CodesignEntitlements="Platforms\MacCatalyst\Entitlements.plist" -p:PackageSigningKey="Developer ID Installer: John Smith (AY2GDE9QM7)" -p:UseHardenedRuntime=true

Publica compilaciones, signos y paquetes de la aplicación y después copia el archivo .pkg en la carpeta bin/Release/net8.0-maccatalyst/publish/. Si publicas la aplicación con una sola arquitectura, se publicará en la carpeta bin/Release/net8.0-maccatalyst/{architecture}/publish/.

Durante el proceso de firma es posible que sea necesario escribir la contraseña de inicio de sesión y permitir la ejecución de codesign y productbuild:

Para obtener más información sobre el comando dotnet publish, consulta Dotnet publish.

Definición de propiedades de compilación en el archivo de proyecto

Una alternativa a especificar parámetros de compilación en la línea de comandos es especificarlos en el archivo del proyecto en <PropertyGroup>. En la tabla siguiente se enumeran algunas de las propiedades de compilación comunes:

Para obtener una lista completa de las propiedades de compilación, consulta Project file properties.

En el ejemplo siguiente se muestra un grupo de propiedades típico para compilar y firmar la aplicación Mac Catalyst para su distribución fuera de Mac App Store:

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net8.0-maccatalyst|AnyCPU'">
  <MtouchLink>SdkOnly</MtouchLink>
  <EnableCodeSigning>True</EnableCodeSigning>
  <EnablePackageSigning>true</EnablePackageSigning>
  <CreatePackage>true</CreatePackage>
  <CodesignKey>Developer ID Application: John Smith (AY2GDE9QM7)</CodesignKey>
  <CodesignProvision>MyMauiApp (Non-App Store)</CodesignProvision>
  <CodesignEntitlements>Platforms\MacCatalyst\Entitlements.plist</CodesignEntitlements>
  <PackageSigningKey>Developer ID Installer: John Smith (AY2GDE9QM7)</PackageSigningKey>
  <UseHardenedRuntime>true</UseHardenedRuntime>
</PropertyGroup>

En este ejemplo <PropertyGroup> se agrega una comprobación de condición, lo que impide que se procese la configuración a menos que se supere la comprobación de condición. La comprobación de condición busca dos elementos:

1. La configuración de compilación está establecida en Release.
2. El marco de trabajo de destino está establecida en algo que contiene el texto net8.0-maccatalyst.
3. La plataforma está establecida en AnyCPU.

Si se produce un error en alguna de estas condiciones, la configuración no se procesará. Lo que es más importante, los valores <CodesignKey>, <CodesignProvision> y <PackageSigningKey> no están establecidos lo que impide que la aplicación se firme.

Después de agregar el grupo de propiedades anterior, la aplicación se puede publicar desde la línea de comandos de un equipo Mac abriendo un terminal y yendo a la carpeta del proyecto de aplicación .NET MAUI. Ejecute el siguiente comando:

dotnet build -f net8.0-maccatalyst -c Release

Publica compilaciones, signos y paquetes de la aplicación y después copia el archivo .pkg en la carpeta bin/Release/net8.0-maccatalyst/publish/.

Certificación de tu aplicación

macOS incluye una tecnología denominada Gatekeeper, que ayuda a garantizar que solo el software de confianza se ejecute en un equipo Mac. Cuando un usuario descarga y abre un paquete de instalador o una aplicación, Gatekeeper comprueba que el software procede de un desarrollador identificado. Para ello, comprueba si hay un certificado de id. de desarrollador y comprueba que Apple notifique el software para que esté libre de contenido malintencionado conocido y no se haya modificado. Por lo tanto, después de aprovisionar y publicar la aplicación, debes enviarla a Apple para que se notifique. El servicio notarial de Apple examina automáticamente la aplicación firmada por el identificador de desarrollador y realiza comprobaciones de seguridad. Cuando la certificación notarial se realice correctamente, se le asignará un vale para que Gatekeeper sepa que se ha registrado bajo notario.

Las aplicaciones se pueden enviar al servicio notarial de Apple con la herramienta de línea de comandos notarytool:

xcrun notarytool submit {my_package_filename} --wait --apple-id {my_apple_id} --password {my_app_specific_password} --team-id {my_team_id}

A continuación se muestra un ejemplo de uso de la herramientas notarytool para firmar un archivo .pkg de .NET MAUI Mac Catalyst:

xcrun notarytool submit MyMauiApp-1.0.pkg --wait --apple-id johm.smith@provider.com --password fqtk-cprr-gqdt-bvyo --team-id AY2GDE9QM7

La marca wait indica a notarytool que salga solo después de que el servicio notarial termine de procesar el envío, por lo que quita la necesidad de sondear el servicio por su estado. Los argumentos apple-id, password y team-id se usan para proporcionar las credenciales de App Store Connect. Dado que App Store Connect requiere autenticación en dos fases, debes crear una contraseña específica de la aplicación para notarytool. Para obtener información sobre cómo crear una contraseña específica de la aplicación, consulta Iniciar sesión en las apps con el ID de Apple usando contraseñas específicas para apps en developer.apple.com.

Después de enviar tu aplicación a Apple, el proceso de certificación suele tardar menos de una hora.

Siempre que la certificación se realice correctamente, el servicio de certificación genera un vale para el paquete del instalador firmado y el lote de aplicaciones dentro de él.

Para obtener más información sobre la certificación, consulta Certificación del software de macOS antes de la distribución. Para obtener otros enfoques para enviar la aplicación al servicio de certificación de Apple, consulta Upload your app to the notarization service en developer.apple.com. Para obtener información sobre cómo resolver problemas comunes de certificación, consulta Resolución de problemas comunes de certificación.

Fijación del vale a tu aplicación

La certificación genera un vale para el paquete del instalador firmado y el lote de aplicaciones que contiene, que indica a Gatekeeper que la aplicación está certificada. Una vez completada la certificación, cuando los usuarios intentan ejecutar la aplicación en macOS 10.14 o posterior, Gatekeeper busca el vale en línea.

Una vez que la certificación se haya realizado correctamente, debes adjuntar el vale a la aplicación mediante la herramienta stapler. Esto garantiza que Gatekeeper pueda encontrar el vale incluso cuando no haya una conexión de red disponible. Ejecuta el siguiente comando para adjuntar el vale a tu .pkg:

xcrun stapler staple {filename}.pkg

La herramienta stapler recupera el vale y lo adjunta al paquete del instalador. Recibirás un mensaje que te indica que la acción de fijación y validación ha funcionado, siempre que la fijación se realice correctamente.

Validación de la certificación

Si deseas validar la certificación, puedes hacerlo con el siguiente comando:

xcrun stapler validate mypackage.pkg

Distribuir la aplicación

El archivo .pkg firmado y certificado se puede distribuir de forma segura fuera de Mac App Store en una ubicación de tu elección, como un servidor web.

Para obtener información sobre cómo abrir aplicaciones de forma segura en un equipo Mac, consulta Abrir apps de forma segura en el Mac en support.apple.com.

Consulta también

• Preparación de la aplicación para la distribución en developer.apple.com
• Hardened Runtime en developer.apple.com
• Customizing the notarization workflow en developer.apple.com