fetch-signing-files =================== **Fetch provisioning profiles and code signing certificates for Bundle ID with given identifier** ### Usage ```bash app-store-connect fetch-signing-files [-h] [--log-stream STREAM] [--no-color] [--version] [-s] [-v] [--log-api-calls] [--api-unauthorized-retries UNAUTHORIZED_REQUEST_RETRIES] [--api-server-error-retries SERVER_ERROR_RETRIES] [--disable-jwt-cache] [--json] [--issuer-id ISSUER_ID] [--key-id KEY_IDENTIFIER] [--private-key PRIVATE_KEY] [--certificates-dir CERTIFICATES_DIRECTORY] [--profiles-dir PROFILES_DIRECTORY] [--platform PLATFORM] [--certificate-key PRIVATE_KEY] [--certificate-key-password PRIVATE_KEY_PASSWORD] [--p12-password P12_CONTAINER_PASSWORD] [--type PROFILE_TYPE] [--strict-match-identifier] [--create] [--delete-stale-profiles] BUNDLE_ID_IDENTIFIER ``` ### Required arguments for action `fetch-signing-files` ##### `BUNDLE_ID_IDENTIFIER` Identifier of the Bundle ID. For example `com.example.app` ### Optional arguments for action `fetch-signing-files` ##### `--platform=IOS | MAC_OS | UNIVERSAL | SERVICES` Bundle ID platform. Default: `IOS` ##### `--certificate-key=PRIVATE_KEY` Private key used to generate the certificate. Used together with `--save` or `--create` options. If not given, the value will be checked from the environment variable `CERTIFICATE_PRIVATE_KEY`. Alternatively to entering CERTIFICATE_KEY in plaintext, it may also be specified using the `@env:` prefix followed by an environment variable name, or the `@file:` prefix followed by a path to the file containing the value. Example: `@env:` uses the value in the environment variable named ``, and `@file:` uses the value from the file at ``. ##### `--certificate-key-password=PRIVATE_KEY_PASSWORD` Password of the private key used to generate the certificate. Used together with `--certificate-key` or `--certificate-key-path` options if the provided key is encrypted. If not given, the value will be checked from the environment variable `CERTIFICATE_PRIVATE_KEY_PASSWORD`. Alternatively to entering CERTIFICATE_KEY_PASSWORD in plaintext, it may also be specified using the `@env:` prefix followed by an environment variable name, or the `@file:` prefix followed by a path to the file containing the value. Example: `@env:` uses the value in the environment variable named ``, and `@file:` uses the value from the file at ``. ##### `--p12-password=P12_CONTAINER_PASSWORD` If provided, the saved p12 container will be encrypted using this password. Used together with `--save` option. ##### `--type=IOS_APP_ADHOC | IOS_APP_DEVELOPMENT | IOS_APP_INHOUSE | IOS_APP_STORE | MAC_APP_DEVELOPMENT | MAC_APP_DIRECT | MAC_APP_STORE | MAC_CATALYST_APP_DEVELOPMENT | MAC_CATALYST_APP_DIRECT | MAC_CATALYST_APP_STORE | TVOS_APP_ADHOC | TVOS_APP_DEVELOPMENT | TVOS_APP_INHOUSE | TVOS_APP_STORE` Type of the provisioning profile. Default: `IOS_APP_DEVELOPMENT` ##### `--strict-match-identifier` Only match Bundle IDs that have exactly the same identifier specified by `BUNDLE_ID_IDENTIFIER`. By default identifier `com.example.app` also matches Bundle IDs with identifier such as `com.example.app.extension` ##### `--create` Whether to create the resource if it does not exist yet ##### `--delete-stale-profiles` Whether to delete invalid provisioning profiles that are discovered for specified bundle identifiers. Those profiles have active status with expiration date in the past, rendering them invalid. Such profiles are not shown in the Apple Developer Portal and they cannot be discovered using conventional read or list API queries. ### Optional arguments for command `app-store-connect` ##### `--log-api-calls` Turn on logging for App Store Connect API HTTP requests ##### `--api-unauthorized-retries, -r=UNAUTHORIZED_REQUEST_RETRIES` Specify how many times the App Store Connect API request should be retried in case the called request fails due to an authentication error (401 Unauthorized response from the server). In case of the above authentication error, the request is retried usinga new JSON Web Token as many times until the number of retries is exhausted. If not given, the value will be checked from the environment variable `APP_STORE_CONNECT_API_UNAUTHORIZED_RETRIES`. [Default: 3] ##### `--api-server-error-retries=SERVER_ERROR_RETRIES` Specify how many times the App Store Connect API request should be retried in case the called request fails due to a server error (response with status code 5xx). In case of server error, the request is retried until the number of retries is exhausted. If not given, the value will be checked from the environment variable `APP_STORE_CONNECT_API_SERVER_ERROR_RETRIES`. [Default: 3] ##### `--disable-jwt-cache` Turn off caching App Store Connect JSON Web Tokens to disk. By default generated tokens are cached to disk to be reused between separate processes, which can can reduce number of false positive authentication errors from App Store Connect API. If not given, the value will be checked from the environment variable `APP_STORE_CONNECT_DISABLE_JWT_CACHE`. ##### `--json` Whether to show the resource in JSON format ##### `--issuer-id=ISSUER_ID` App Store Connect API Key Issuer ID. Identifies the issuer who created the authentication token. Learn more at https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api. If not given, the value will be checked from the environment variable `APP_STORE_CONNECT_ISSUER_ID`. Alternatively to entering `ISSUER_ID` in plaintext, it may also be specified using the `@env:` prefix followed by an environment variable name, or the `@file:` prefix followed by a path to the file containing the value. Example: `@env:` uses the value in the environment variable named ``, and `@file:` uses the value from the file at ``. ##### `--key-id=KEY_IDENTIFIER` App Store Connect API Key ID. Learn more at https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api. If not given, the value will be checked from the environment variable `APP_STORE_CONNECT_KEY_IDENTIFIER`. Alternatively to entering `KEY_IDENTIFIER` in plaintext, it may also be specified using the `@env:` prefix followed by an environment variable name, or the `@file:` prefix followed by a path to the file containing the value. Example: `@env:` uses the value in the environment variable named ``, and `@file:` uses the value from the file at ``. ##### `--private-key=PRIVATE_KEY` App Store Connect API private key used for JWT authentication to communicate with Apple services. Learn more at https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api. If not provided, the key will be searched from the following directories in sequence for a private key file with the name `AuthKey_.p8`: private_keys, ~/private_keys, ~/.private_keys, ~/.appstoreconnect/private_keys, where is the value of `--key-id`. If not given, the value will be checked from the environment variable `APP_STORE_CONNECT_PRIVATE_KEY`. Alternatively to entering `PRIVATE_KEY` in plaintext, it may also be specified using the `@env:` prefix followed by an environment variable name, or the `@file:` prefix followed by a path to the file containing the value. Example: `@env:` uses the value in the environment variable named ``, and `@file:` uses the value from the file at ``. ##### `--certificates-dir=CERTIFICATES_DIRECTORY` Directory where the code signing certificates will be saved. Default: `$HOME/Library/MobileDevice/Certificates` ##### `--profiles-dir=PROFILES_DIRECTORY` Directory where the provisioning profiles will be saved. Default: `$HOME/Library/MobileDevice/Provisioning Profiles` ### Common options ##### `-h, --help` show this help message and exit ##### `--log-stream=stderr | stdout` Log output stream. Default `stderr` ##### `--no-color` Do not use ANSI colors to format terminal output ##### `--version` Show tool version and exit ##### `-s, --silent` Disable log output for commands ##### `-v, --verbose` Enable verbose logging for commands