Automate administrative tasks that you would normally have to do through the Apple Dev Center websites. Life's too short to manage device identifiers by hand!
Cupertino is named after Cupertino, CA: home to Apple, Inc.'s world headquarters. It's part of a series of world-class command-line utilities for iOS development, which includes Shenzhen (Building & Distribution), Houston (Push Notifications), Venice (In-App Purchase Receipt Verification), Dubai (Passbook pass generation), and Nashville (iTunes Store API).
Cupertino requires the Xcode Command Line Tools, which can be installed with the following command:
$ xcode-select --install
$ gem install cupertino
$ ios login
$ ios [command] -u [username] -p [password]
Credentials are saved in the Keychain. You will not be prompted for your username or password by commands while you are logged in. (Mac only)
$ ios [command] --team [TEAM]
This is also an interactive choice
$ ios devices:list
+------------------------------+---------------------------------------+
| Listing 2 devices. You can register 98 additional devices. |
+---------------------------+------------------------------------------+
| Device Name | Device Identifier |
+---------------------------+------------------------------------------+
| Johnny Appleseed iPad | 0123456789012345678901234567890123abcdef |
| Johnny Appleseed iPhone | abcdef0123456789012345678901234567890123 |
+---------------------------+------------------------------------------+
$ ios devices:add "iPad 1"=abc123
$ ios devices:add "iPad 2"=def456 "iPad 3"=ghi789 ...
$ ios profiles:list
+----------------------------------+--------------+---------+
| Profile | App ID | Status |
+----------------------------------+--------------+---------+
| iOS Team Provisioning Profile: * | ABCDEFG123.* | Valid |
+----------------------------------+--------------+---------+
$ ios profiles:create "Profile 1" "ABCDEFG123.com.company.app"
Development profile created with all certificates and all devices
$ ios profiles:create --download "Profile 1" "ABCDEFG123.com.company.app"
Downloaded Profile_1.mobileprovision
$ ios profiles:create --certificateid "AB123XYZG" "Profile 1" "ABCDEFG123.com.company.app"
Development profile created with 1 certificate and all devices
$ ios profiles:create --type appstore --certificateid "AB123XYZG" "Profile 1" "ABCDEFG123.com.company.app"
App Store profile created called Profile 1
$ ios profiles:create --type adhoc --certificateid "AB123XYZG" "Profile 1" "ABCDEFG123.com.company.app"
Ad Hoc profile created with 1 certificate and all devices
$ ios profiles:manage:devices
Opens an editor with a list of devices, each of which can be commented / uncommented to turn them off / on for that provisioning profile.
# Comment / Uncomment Devices to Turn Off / On for Provisioning Profile
Johnny Appleseed iPad 0123456789012345678901234567890123abcdef
# Johnny Appleseed iPhone abcdef0123456789012345678901234567890123
$ ios profiles:devices:add MyApp_Development_Profile "Johnny Appleseed iPad"=0123456789012345678901234567890123abcdef "Johnny Appleseed iPhone"=abcdef0123456789012345678901234567890123
Adds (without an editor) a list of devices to a provisioning profile
$ ios profiles:devices:remove MyApp_Development_Profile "Johnny Old iPad"=0123456789012345678901234567890123abcdef "Johnny Old iPhone"=abcdef0123456789012345678901234567890123
Removes (without an editor) a list of devices from a provisioning profile
$ ios profiles:devices:list MyApp_Development_Profile
+--------------------------+------------------------------------------+--------+
| Listing devices for provisioning profile MyApp_Development_Profile |
+--------------------------+------------------------------------------+--------+
| Device Name | Device Identifier | Active |
+--------------------------+------------------------------------------+--------+
| Person's iPhone 5 | 888888883e48a3e0458aab2691d565a8a63f7888 | Y |
+--------------------------+------------------------------------------+--------+
$ ios app_ids:list
+-----------------------------+------------------------+-------------------+-------------------+
| Bundle Seed ID | Description | Development | Distribution |
+-----------------------------+------------------------+-------------------+-------------------+
| 123ABCDEFG.com.mattt.bundle | App Bundle Description | Passes | Passes |
| | | Data Protection | Data Protection |
| | | iCloud | iCloud |
| | | In-App Purchase | In-App Purchase |
| | | Game Center | Game Center |
| | | Push Notification | Push Notification |
+-----------------------------+------------------------+-------------------+-------------------+
$ ios app_ids:add "App Bundle Description"=123ABCDEFG.com.mattt.bundle
$ ios certificates:list
+------------------+----------------------------------+-----------------+--------+
| Name | Provisioning Profiles | Expiration Date | Status |
+------------------+----------------------------------+-----------------+--------+
| Johnny Appleseed | iOS Team Provisioning Profile: * | Dec 23, 2012 | Issued |
+------------------+----------------------------------+-----------------+--------+
$ ios certificates:download
$ ios certificates:download --type distribution
$ ios certificates:download NAME
$ ios certificates:create request.csr
$ ios certificates:create --type devpush request.csr 123ABCDEFG.com.mattt.bundle
$ ios certificates:create --type production request.csr
$ ios certificates:create --type prodpush request.csr 123ABCDEFG.com.mattt.bundle
$ ios certificates:create --type prodpush --download --internalid request.csr
$ ios certificates:create --download request.csr
$ ios certificates:create --download --internalid --type TYPE CSR (APPID)
App ID is required for Push Certificates.
The download flag retrieves the certificate file to the current directory
The internalid flag quiets all output but returns Apple's internal id for the created certificate to the STDOUT. Can be used in combination with the download flag.
The following commands will format their output as comma-separated values when the --format csv argument is passed:
app_ids:listdevices:listprofiles:listprofiles:manage:devices:list
loginlogoutdevices:adddevices:listprofiles:listprofiles:createprofiles:manage:devicesprofiles:manage:devices:addprofiles:manage:devices:removeprofiles:downloadprofiles:download:allprofiles:devices:listcertificates:listcertificates:downloadcertificates:createapp_ids:addapp_ids:list
Cupertino will access the provisioning portal through a proxy if the HTTP_PROXY environment variable is set, with optional credentials HTTP_PROXY_USER and HTTP_PROXY_PASSWORD.
Mattt Thompson (@mattt)
Cupertino is available under the MIT license. See the LICENSE file for more info.