./README.md in cupertino-0.7.1 vs ./README.md in cupertino-0.8.0

- old
+ new

@@ -1,183 +1,108 @@ # Cupertino **CLI for the Apple Dev Center** 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! -This project is starting with the iOS Provisioning Portal, and may later expand to include iTunes Connect and/or Mac Developer Certificate Utility. +> Cupertino is named after [Cupertino, CA](http://en.wikipedia.org/wiki/Cupertino,_California): 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](https://github.com/mattt/shenzhen) (Building & Distribution), [Houston](https://github.com/mattt/houston) (Push Notifications), [Venice](https://github.com/mattt/venice) (In-App Purchase Receipt Verification), and [Dubai](https://github.com/mattt/dubai) (Passbook pass generation). ## Installation -```sh -$ gem install cupertino -``` + $ gem install cupertino ## Usage ### Authentication -```sh -$ ios login -``` + $ ios login + _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)_ ### Devices -```sh -$ ios devices:list + $ ios devices:list -+------------------------------+---------------------------------------+ -| Listing 2 devices. You can register 98 additional devices. | -+---------------------------+------------------------------------------+ -| Device Name | Device Identifier | -+---------------------------+------------------------------------------+ -| Johnny Appleseed iPad | 0123456789012345678901234567890123abcdef | -| Johnny Appleseed iPhone | abcdef0123456789012345678901234567890123 | -+---------------------------+------------------------------------------+ + +------------------------------+---------------------------------------+ + | 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 devices:add "iPad 1"=abc123 + $ ios devices:add "iPad 2"=def456 "iPad 3"=ghi789 ... ### Provisioning Profiles -```sh -$ ios profiles:list + $ ios profiles:list -+----------------------------------+--------------+---------+ -| Profile | App ID | Status | -+----------------------------------+--------------+---------+ -| iOS Team Provisioning Profile: * | ABCDEFG123.* | Valid | -+----------------------------------+--------------+---------+ -``` + +----------------------------------+--------------+---------+ + | Profile | App ID | Status | + +----------------------------------+--------------+---------+ + | iOS Team Provisioning Profile: * | ABCDEFG123.* | Valid | + +----------------------------------+--------------+---------+ --- -```sh -$ ios profiles:manage: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 -``` + # Comment / Uncomment Devices to Turn Off / On for Provisioning Profile + Johnny Appleseed iPad 0123456789012345678901234567890123abcdef + # Johnny Appleseed iPhone abcdef0123456789012345678901234567890123 ### App IDs -```sh -$ ios app_ids:list + $ 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 | -+-----------------------------+------------------------+-------------------+-------------------+ -``` + +-----------------------------+------------------------+-------------------+-------------------+ + | 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 | + +-----------------------------+------------------------+-------------------+-------------------+ ### Certificates -``` -$ ios certificates:list + $ ios certificates:list -+------------------+----------------------------------+-----------------+--------+ -| Name | Provisioning Profiles | Expiration Date | Status | -+------------------+----------------------------------+-----------------+--------+ -| Johnny Appleseed | iOS Team Provisioning Profile: * | Dec 23, 2012 | Issued | -+------------------+----------------------------------+-----------------+--------+ -``` + +------------------+----------------------------------+-----------------+--------+ + | Name | Provisioning Profiles | Expiration Date | Status | + +------------------+----------------------------------+-----------------+--------+ + | Johnny Appleseed | iOS Team Provisioning Profile: * | Dec 23, 2012 | Issued | + +------------------+----------------------------------+-----------------+--------+ -### Pass Type IDs - -```sh -$ ios pass_type_ids:add pass.com.example.coupon.myExamplePass --description "My Example Pass Coupon" - -Added pass.com.example.coupon.myExamplePass: My Example Pass Coupon -``` - ---- - -```sh -$ ios pass_type_ids:list - -+------------+--------------------------------------------+--------------+-------------------+ -| Card ID | Identifier | Description | Pass Certificates | -+------------+--------------------------------------------+--------------+-------------------+ -| WWWWWWWWWW | pass.com.example.coupon.myExamplePass | Coupon | None | -| XXXXXXXXXX | pass.com.example.eventTicket.myExamplePass | Event Ticket | Pass Certificate | -| YYYYYYYYYY | pass.com.example.movieTicket.myExamplePass | Movie Ticket | Pass Certificate | -| ZZZZZZZZZZ | pass.com.example.test.001 | Test | Pass Certificate | -+------------+--------------------------------------------+--------------+-------------------+ -``` - ---- - -```sh -$ ios pass_type_ids:certificates:add pass.com.example.coupon.myExamplePass --csr /path/to/csr - -Configured pass.com.example.coupon.myExamplePass. Apple is generating the certificate... -Certificate generated and is ready to be downloaded. -``` - ---- - -```sh -$ ios pass_type_ids:certificates:list pass.com.example.coupon.myExamplePass - -+------------------+------------+-----------------+----------------+ -| Name | Status | Expiration Date | Certificate ID | -+------------------+------------+-----------------+----------------+ -| Pass Certificate | Configured | Nov 21, 2013 | AAAAAAAAAA | -+------------------+------------+-----------------+----------------+ -``` - ---- - -```sh -$ ios pass_type_ids:certificates:download pass.com.example.coupon.myExamplePass --certificate_id AAAAAAAAAA - -Successfully downloaded: 'AAAAAAAAAA.cer' -``` - ## Commands -_Crossed out commands are not yet implemented_ - - `login` - `logout` - - `devices:add` - `devices:list` -- ~~`devices:remove`~~ - - `profiles:list` - `profiles:manage:devices` - `profiles:download` -- ~~`profiles:add`~~ -- ~~`profiles:edit`~~ - - `certificates:list [development|distribution]` - `certificates:download` -- ~~`certificates:revoke CERTIFICATE_NAME`~~ - - `app_ids:list` -- ~~`app_ids:new`~~ +### Disabled Commands + +> With the latest updates to the Apple Developer Portal, the following functionality has been removed. + - `pass_type_ids:list` - `pass_type_ids:add` -- ~~`pass_type_ids:remove`~~ - `pass_type_ids:certificates:list` - `pass_type_ids:certificates:add` - `pass_type_ids:certificates:download` -- ~~`pass_type_ids:certificates:revoke CERTIFICATE_NAME`~~ ## Contact Mattt Thompson