|
| 1 | + |
| 2 | +create |
| 3 | +====== |
| 4 | + |
| 5 | + |
| 6 | +**Create an App Store Version Localization. Add localized version-level information for a new locale.** |
| 7 | +### Usage |
| 8 | +```bash |
| 9 | +app-store-connect app-store-version-localizations create [-h] [--log-stream STREAM] [--no-color] [--version] [-s] [-v] |
| 10 | + [--log-api-calls] |
| 11 | + [--json] |
| 12 | + [--issuer-id ISSUER_ID] |
| 13 | + [--key-id KEY_IDENTIFIER] |
| 14 | + [--private-key PRIVATE_KEY] |
| 15 | + [--certificates-dir CERTIFICATES_DIRECTORY] |
| 16 | + [--profiles-dir PROFILES_DIRECTORY] |
| 17 | + [--description DESCRIPTION] |
| 18 | + [--keywords KEYWORDS] |
| 19 | + [--marketing-url MARKETING_URL] |
| 20 | + [--promotional-text PROMOTIONAL_TEXT] |
| 21 | + [--support-url SUPPORT_URL] |
| 22 | + [--whats-new WHATS_NEW] |
| 23 | + APP_STORE_VERSION_ID |
| 24 | + LOCALE |
| 25 | +``` |
| 26 | +### Required arguments for action `create` |
| 27 | + |
| 28 | +##### `APP_STORE_VERSION_ID` |
| 29 | + |
| 30 | + |
| 31 | +UUID value of the App Store Version |
| 32 | +##### `LOCALE` |
| 33 | + |
| 34 | + |
| 35 | +The locale code name for App Store metadata in different languages. See available locale code names from https://developer.apple.com/documentation/appstoreconnectapi/betabuildlocalizationcreaterequest/data/attributes |
| 36 | +### Optional arguments for action `create` |
| 37 | + |
| 38 | +##### `--description, -d=DESCRIPTION` |
| 39 | + |
| 40 | + |
| 41 | +A description of your app, detailing features and functionality. |
| 42 | +##### `--keywords, -k=KEYWORDS` |
| 43 | + |
| 44 | + |
| 45 | +Include one or more keywords that describe your app. Keywords make App Store search results more accurate. Separate keywords with an English comma, Chinese comma, or a mix of both. |
| 46 | +##### `--marketing-url=MARKETING_URL` |
| 47 | + |
| 48 | + |
| 49 | +A URL with marketing information about your app. This URL will be visible on the App Store. |
| 50 | +##### `--promotional-text=PROMOTIONAL_TEXT` |
| 51 | + |
| 52 | + |
| 53 | +Promotional text lets you inform your App Store visitors of any current app features without requiring an updated submission. This text will appear above your description on the App Store for customers with devices running iOS 11 or later, and macOS 10.13 or later. |
| 54 | +##### `--support-url=SUPPORT_URL` |
| 55 | + |
| 56 | + |
| 57 | +A URL with support information for your app. This URL will be visible on the App Store. |
| 58 | +##### `--whats-new, -n=WHATS_NEW` |
| 59 | + |
| 60 | + |
| 61 | +Describe what's new in this version of your app, such as new features, improvements, and bug fixes. If not given, the value will be checked from the environment variable `APP_STORE_CONNECT_WHATS_NEW`. Alternatively to entering `WHATS_NEW` 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>`. |
| 62 | +### Optional arguments for command `app-store-connect` |
| 63 | + |
| 64 | +##### `--log-api-calls` |
| 65 | + |
| 66 | + |
| 67 | +Turn on logging for App Store Connect API HTTP requests |
| 68 | +##### `--json` |
| 69 | + |
| 70 | + |
| 71 | +Whether to show the resource in JSON format |
| 72 | +##### `--issuer-id=ISSUER_ID` |
| 73 | + |
| 74 | + |
| 75 | +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>`. |
| 76 | +##### `--key-id=KEY_IDENTIFIER` |
| 77 | + |
| 78 | + |
| 79 | +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>`. |
| 80 | +##### `--private-key=PRIVATE_KEY` |
| 81 | + |
| 82 | + |
| 83 | +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>`. |
| 84 | +##### `--certificates-dir=CERTIFICATES_DIRECTORY` |
| 85 | + |
| 86 | + |
| 87 | +Directory where the code signing certificates will be saved. Default: `$HOME/Library/MobileDevice/Certificates` |
| 88 | +##### `--profiles-dir=PROFILES_DIRECTORY` |
| 89 | + |
| 90 | + |
| 91 | +Directory where the provisioning profiles will be saved. Default: `$HOME/Library/MobileDevice/Provisioning Profiles` |
| 92 | +### Common options |
| 93 | + |
| 94 | +##### `-h, --help` |
| 95 | + |
| 96 | + |
| 97 | +show this help message and exit |
| 98 | +##### `--log-stream=stderr | stdout` |
| 99 | + |
| 100 | + |
| 101 | +Log output stream. Default `stderr` |
| 102 | +##### `--no-color` |
| 103 | + |
| 104 | + |
| 105 | +Do not use ANSI colors to format terminal output |
| 106 | +##### `--version` |
| 107 | + |
| 108 | + |
| 109 | +Show tool version and exit |
| 110 | +##### `-s, --silent` |
| 111 | + |
| 112 | + |
| 113 | +Disable log output for commands |
| 114 | +##### `-v, --verbose` |
| 115 | + |
| 116 | + |
| 117 | +Enable verbose logging for commands |
0 commit comments