produce¶

Alias for the create_app_online action

Create new iOS apps on App Store Connect and Dev Portal using your command line¶

produce creates new iOS apps on both the Apple Developer Portal and App Store Connect with the minimum required information.

Features • Usage • How does it work?

Features¶

Create new apps on both App Store Connect and the Apple Developer Portal
Modify Application Services on the Apple Developer Portal
Create App Groups on the Apple Developer Portal
Associate apps with App Groups on the Apple Developer Portal
Create Merchant Identifiers on the Apple Developer Portal
Associate apps with Merchant Identifiers on the Apple Developer Portal
Support for multiple Apple accounts, storing your credentials securely in the Keychain

Usage¶

Creating a new application¶

fastlane produce

To get a list of all available parameters:

fastlane produce --help

Commands: (* default)
  associate_group      Associate with a group, which is created if needed or simply located otherwise
  associate_merchant   Associate with a merchant for use with Apple Pay. Apple Pay will be enabled for this app
  create             * Creates a new app on App Store Connect and the Apple Developer Portal
  disable_services     Disable specific Application Services for a specific app on the Apple Developer Portal
  enable_services      Enable specific Application Services for a specific app on the Apple Developer Portal
  group                Ensure that a specific App Group exists
  help                 Display global or [command] help documentation
  merchant             Ensure that a specific Merchant exists

Global Options:
  --verbose
  -h, --help           Display help documentation
  -v, --version        Display version information

Options for create:
  -u, --username STRING Your Apple ID Username (PRODUCE_USERNAME)
  -a, --app_identifier STRING App Identifier (Bundle ID, e.g. com.krausefx.app) (PRODUCE_APP_IDENTIFIER)
  -e, --bundle_identifier_suffix STRING App Identifier Suffix (Ignored if App Identifier does not ends with .*) (PRODUCE_APP_IDENTIFIER_SUFFIX)
  -q, --app_name STRING App Name (PRODUCE_APP_NAME)
  -z, --app_version STRING Initial version number (e.g. '1.0') (PRODUCE_VERSION)
  -y, --sku STRING     SKU Number (e.g. '1234') (PRODUCE_SKU)
  -j, --platform STRING The platform to use (optional) (PRODUCE_PLATFORM)
  -m, --language STRING Primary Language (e.g. 'English', 'German') (PRODUCE_LANGUAGE)
  -c, --company_name STRING The name of your company. Only required if it's the first app you create (PRODUCE_COMPANY_NAME)
  -i, --skip_itc [VALUE] Skip the creation of the app on App Store Connect (PRODUCE_SKIP_ITC)
  -d, --skip_devcenter [VALUE] Skip the creation of the app on the Apple Developer Portal (PRODUCE_SKIP_DEVCENTER)
  -s, --itc_users ARRAY Array of App Store Connect users. If provided, you can limit access to this newly created app for users with the App Manager, Developer, Marketer or Sales roles (ITC_USERS)
  -b, --team_id STRING The ID of your Developer Portal team if you're in multiple teams (PRODUCE_TEAM_ID)
  -l, --team_name STRING The name of your Developer Portal team if you're in multiple teams (PRODUCE_TEAM_NAME)
  -k, --itc_team_id [VALUE] The ID of your App Store Connect team if you're in multiple teams (PRODUCE_ITC_TEAM_ID)
  -p, --itc_team_name STRING The name of your App Store Connect team if you're in multiple teams (PRODUCE_ITC_TEAM_NAME)

Enabling / Disabling Application Services¶

If you want to enable Application Services for an App ID (HomeKit and HealthKit in this example):

fastlane produce enable_services --homekit --healthkit

If you want to disable Application Services for an App ID (iCloud in this case):

fastlane produce disable_services --icloud

If you want to create a new App Group:

fastlane produce group -g group.krausefx -n "Example App Group"

If you want to associate an app with an App Group:

fastlane produce associate_group -a com.krausefx.app group.krausefx

Parameters¶

Get a list of all available options using

fastlane produce enable_services --help

--app-group          Enable App Groups
--apple-pay          Enable Apple Pay
--associated-domains Enable Associated Domains
--data-protection STRING Enable Data Protection, suitable values are "complete", "unlessopen" and "untilfirstauth"
--game-center        Enable Game Center
--healthkit          Enable HealthKit
--homekit            Enable HomeKit
--hotspot            Enable Hotspot
--icloud STRING      Enable iCloud, suitable values are "legacy" and "cloudkit"
--in-app-purchase    Enable In-App Purchase
--inter-app-audio    Enable Inter-App-Audio
--multipath          Enable Multipath
--network-extension  Enable Network Extensions
--nfc-tag-reading    Enable NFC Tag Reading
--personal-vpn       Enable Personal VPN
--passbook           Enable Passbook (deprecated)
--push-notification  Enable Push notification (only enables the service, does not configure certificates)
--sirikit            Enable SiriKit
--vpn-conf           Enable VPN Configuration (deprecated)
--wallet             Enable Wallet
--wireless-conf      Enable Wireless Accessory Configuration

fastlane produce disable_services --help

--app-group          Disable App Groups
--apple-pay          Disable Apple Pay
--associated-domains Disable Associated Domains
--data-protection    Disable Data Protection
--game-center        Disable Game Center
--healthkit          Disable HealthKit
--homekit            Disable HomeKit
--hotspot            Disable Hotspot
--icloud             Disable iCloud
--in-app-purchase    Disable In-App Purchase
--inter-app-audio    Disable Inter-App-Audio
--multipath          Disable Multipath
--network-extension  Disable Network Extensions
--nfc-tag-reading    Disable NFC Tag Reading
--personal-vpn       Disable Personal VPN
--passbook           Disable Passbook (deprecated)
--push-notification  Disable Push notifications
--sirikit            Disable SiriKit
--vpn-conf           Disable VPN Configuration (deprecated)
--wallet             Disable Wallet
--wireless-conf      Disable Wireless Accessory Configuration

Creating Apple Pay merchants and associating them with an App ID¶

If you want to create a new Apple Pay Merchant Identifier:

fastlane produce merchant -o merchant.com.example.production -r "Example Merchant Production"

Use --help for more information about all available parameters

fastlane produce merchant --help

If you want to associate an app with a Merchant Identifier:

fastlane produce associate_merchant -a com.krausefx.app merchant.com.example.production

If you want to associate an app with multiple Merchant Identifiers:

fastlane produce associate_merchant -a com.krausefx.app merchant.com.example.production merchant.com.example.sandbox

Use --help for more information about all available parameters

fastlane produce associate_merchant --help

Environment Variables¶

All available values can also be passed using environment variables, run fastlane produce --help to get a list of all available parameters.

fastlane Integration¶

Your Fastfile should look like this

lane :release do
  produce(
    username: 'felix@krausefx.com',
    app_identifier: 'com.krausefx.app',
    app_name: 'MyApp',
    language: 'English',
    app_version: '1.0',
    sku: '123',
    team_name: 'SunApps GmbH', # only necessary when in multiple teams

    # Optional
    # App services can be enabled during app creation
    enable_services: {
      app_group: "on",               # Valid values: "on", "off"
      apple_pay: "on",               # Valid values: "on", "off"
      associated_domains: "on",      # Valid values: "on", "off"
      data_protection: "complete",   # Valid values: "complete", "unlessopen", "untilfirstauth",
      game_center: "on",             # Valid values: "on", "off"
      health_kit: "on",              # Valid values: "on", "off"
      home_kit: "on",                # Valid values: "on", "off"
      hotspot: "on",                 # Valid values: "on", "off"
      icloud: "cloudkit",            # Valid values: "legacy", "cloudkit"
      in_app_purchase: "on",         # Valid values: "on", "off"
      inter_app_audio: "on",         # Valid values: "on", "off"
      passbook: "on",                # Valid values: "on", "off"
      multipath: "on",               # Valid values: "on", "off"
      network_extensions: "on",      # Valid values: "on", "off"
      nfc_tag_reading: "on",         # Valid values: "on", "off"
      personal_vpn: "on",            # Valid values: "on", "off"
      passbook: "on",                # Valid values: "on", "off" (deprecated)
      push_notification: "on",       # Valid values: "on", "off"
      siri_kit: "on",                # Valid values: "on", "off"
      vpn_configuration: "on",       # Valid values: "on", "off" (deprecated)
      wallet: "on",                  # Valid values: "on", "off"
      wireless_accessory: "on",      # Valid values: "on", "off"
    }
  )

  deliver
end

To use the newly generated app in deliver, you need to add this line to your Deliverfile:

apple_id(ENV['PRODUCE_APPLE_ID'])

This will tell deliver, which App ID to use, since the app is not yet available in the App Store.

You'll still have to fill out the remaining information (like screenshots, app description and pricing). You can use deliver to upload your app metadata using a CLI

How is my password stored?¶

produce uses the password manager from fastlane. Take a look the CredentialsManager README for more information.

produce
Supported platforms	ios
Author	@KrauseFx

2 Examples¶

create_app_online(
  username: "felix@krausefx.com",
  app_identifier: "com.krausefx.app",
  app_name: "MyApp",
  language: "English",
  app_version: "1.0",
  sku: "123",
  team_name: "SunApps GmbH" # Only necessary when in multiple teams.
)

produce   # alias for "create_app_online"

Parameters¶

Key	Description	Default
`username`	Your Apple ID Username	*
`app_identifier`	App Identifier (Bundle ID, e.g. com.krausefx.app)	*
`bundle_identifier_suffix`	App Identifier Suffix (Ignored if App Identifier does not end with .*)
`app_name`	App Name
`app_version`	Initial version number (e.g. '1.0')
`sku`	SKU Number (e.g. '1234')	*
`platform`	The platform to use (optional)	`ios`
`language`	Primary Language (e.g. 'English', 'German')	`English`
`company_name`	The name of your company. Only required if it's the first app you create
`skip_itc`	Skip the creation of the app on App Store Connect	`false`
`itc_users`	Array of App Store Connect users. If provided, you can limit access to this newly created app for users with the App Manager, Developer, Marketer or Sales roles
`enabled_features`	DEPRECATED! Please use `enable_services` instead - Array with Spaceship App Services	`{}`
`enable_services`	Array with Spaceship App Services (e.g. app_group: (on\|off), apple_pay: (on\|off), associated_domains: (on\|off), data_protection: (complete\|unlessopen\|untilfirstauth), game_center: (on\|off), health_kit: (on\|off), home_kit: (on\|off), hotspot: (on\|off), icloud: (legacy\|cloudkit), in_app_purchase: (on\|off), inter_app_audio: (on\|off), multipath: (on\|off), network_extension: (on\|off), nfc_tag_reading: (on\|off), personal_vpn: (on\|off), passbook: (on\|off), push_notification: (on\|off), siri_kit: (on\|off), vpn_configuration: (on\|off), wallet: (on\|off), wireless_accessory: (on\|off))	`{}`
`skip_devcenter`	Skip the creation of the app on the Apple Developer Portal	`false`
`team_id`	The ID of your Developer Portal team if you're in multiple teams	*
`team_name`	The name of your Developer Portal team if you're in multiple teams	*
`itc_team_id`	The ID of your App Store Connect team if you're in multiple teams	*
`itc_team_name`	The name of your App Store Connect team if you're in multiple teams	*

* = default value is dependent on the user's system

To show the documentation in your terminal, run

fastlane action produce

View source code

Back to actions