Skip to content

Latest commit

 

History

History
97 lines (59 loc) · 5.86 KB

app-store-version-localizations.md

File metadata and controls

97 lines (59 loc) · 5.86 KB
Raw

app-store-version-localizations

Create and maintain version-specific App Store metadata that is localized.

Usage

app-store-connect app-store-version-localizations [-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]
    ACTION

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:<variable> uses the value in the environment variable named <variable>, and @file:<file_path> uses the value from the file at <file_path>.

--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:<variable> uses the value in the environment variable named <variable>, and @file:<file_path> uses the value from the file at <file_path>.

--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_<key_identifier>.p8: private_keys, ~/private_keys, ~/.private_keys, ~/.appstoreconnect/private_keys, where <key_identifier> 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:<variable> uses the value in the environment variable named <variable>, and @file:<file_path> uses the value from the file at <file_path>.

--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

Actions

Action Description
create Create an App Store Version Localization. Add localized version-level information for a new locale.
delete Delete an App Store Version Localization. Remove a language from your version metadata.
get Read App Store Version Localization Information. Get localized version-level information.
modify Modify an App Store Version Localization. Edit localized version-level information for a particular language.