exportation 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6d693139ec49db0068d7bfc42e233a491b62185c
-  data.tar.gz: 0fb5691ea3b24186a91690cf9cdc433dac0e75e5
+  metadata.gz: a7a44bba53279975c5fc54d2e2e5eb0f2c16a558
+  data.tar.gz: b31bb38404206939737b059adc85c4c75067764a
 SHA512:
-  metadata.gz: 7fe3695f34a19866f2184197de06487ab49eaca27133b97f4f3e11f48bfefb392f37672d1ed3ea8cfed4dee9264f047e0a58ca9f3a2962c7b32c9f214cd5183e
-  data.tar.gz: d8a6b360b0bf88d7354929d8bec6147d6a76d89d7f782c6851316ae105dbb2525bdfc41bd10ec5eacf690eee248b27bdcf7c1da3e612158e3d40163ec351136a
+  metadata.gz: b72fc28b8924e6b83b358898e8a562e389eb9d036156164503ea5368d9c3fac094a5635e3471b13d30618002f3fd40109573880aac34c49335633f009bd22875
+  data.tar.gz: 7e5a910660d54e7974ff8850e97aba439ff5ef246faba9a95029afcf2838d2f956e4832eb1e5d5d987efeff4195d698699e05f8ffc5fe8722b807df8a1317139

data/README.md

@@ -6,6 +6,11 @@
 
 CLI tool (and Ruby API) of easy exporting, encrypting, and decrypting of certificates and private keys. It can also add certificates and private keys to an existing or new keychain :grinning:
 
+- [Installation](#installation)
+- [CLI Commands](#cli-commands)
+- [Ruby API](#ruby-api)
+- [Fastlane Integration](#fastlane-integration)
+
 **Important:** The `export` command will take control of your "Keychain Access" app so keep all hands off your computer while that command runs
 
 ### Example usage (with prompt)
@@ -63,7 +68,7 @@ gem install exportation
 - Select "Accessibility"
 - Add **ARDAgent** and **Terminal**
   - Click "+"
-  - Press CMD+SHIT+G (to go to specific folder)
+  - Press CMD+SHIFT+G (to go to specific folder)
   - **ARDAgent** should be under `/System/Library/CoreServices/RemoteManagement/`
   - **Terminal** should be under `/Applications/Utilities/`
 
@@ -86,7 +91,7 @@ exportation encrypt exported.cer exported.p12 --password dudethis
 ```
 
 ### Decrypting certificate and private key
-**Be awesome!** `decrypt` decrypts your encrypted files to use on your CI or for other developers to install. *BE CAREFULL TO NOT COMMIT THESE BACK INTO YOUR REPO*
+**Be awesome!** `decrypt` decrypts your encrypted files to use on your CI or for other developers to install. *BE CAREFUL TO NOT COMMIT THESE BACK INTO YOUR REPO*
 ```sh
 exportation decrypt exported.cer.enc exported.p12.enc --password dudethis
 ```
@@ -147,6 +152,106 @@ keychain.add_to_keychain_list!
 keychain.remove_keychain_from_list!
 ```
 
+## Fastlane integration
+In this `fastlane` integration, I store my encrypted certificate and private key in the `circle` directory (because I'm using [CircleCI](http://circleci.com).
+
+The `enc_cert_and_key` lane runs on my local machine where I will export and encrypt the certificate and private key.
+
+The `ci_build` *can run* on my local machine but is **meant to run** on CircleCI (or TravisCI). This lane decrypts the certifivate and private key from the `circle` directory and puts the decrypted files in the `build/unenc` directory.
+
+### Exporting and encrypting
+This lane exports the certificate and private key by controling keychain access, encrypts the files, and the removes the unencrypted files.
+```ruby
+lane :enc_cert_and_key do
+  require 'exportation'
+
+  # Runs keychain to export cert and private key
+  Exportation::Export.new(
+    path: "../circle",
+    filename: "dist",
+    name: "RokkinCat LLC",
+    password: ENV['PKEY_PASSWORD']
+  ).run
+
+  # Encrypts cert and private key for repo storage
+  Exportation::Crypter.new(
+    files: ["../circle/dist.cer", "../circle/dist.p12"],
+    password: ENV['ENC_PASSWORD'],
+    output: "../circle/"
+  ).run :en
+
+  # Removes unencrypted cert and private key
+  sh "rm -f ../circle/dist.cer"
+  sh "rm -f ../circle/dist.p12"
+
+end
+```
+
+### Decrypting and importing
+This lane decrypts the certificate and private key, creates the keychain, and imports the certificate and private key into the keychain.
+It then uses that keychain the `xcodebuild` action to build an archive of the app.
+```ruby
+lane :ci_build do
+  require 'exportation'
+
+  enc_password = ENV['ENC_PASSWORD']
+  keychain_password = ENV['KEYCHAIN_PASSWORD']
+  private_key_password = ENV['PKEY_PASSWORD']
+
+  # Cleaning house and making directories
+  sh "rm -rf ../build"
+  sh "mkdir ../build"
+  sh "mkdir ../build/unenc"
+
+  # Decrypting cert and private key
+  Exportation::Crypter.new(
+    files: ["../circle/dist.cer.enc", "../circle/dist.p12.enc"],
+    password: enc_password,
+    output: "../build/unenc/"
+  ).run :de
+
+  # Creating keychain to use for xcodebuild
+  keychain = Exportation::Keychain.find_or_create_keychain 'ios-build', keychain_password, '../build'
+
+  # Importing the Apple certificate and the uncrypted cert and private key
+  keychain.import_certificate '../circle/apple.cer'
+  keychain.import_certificate '../build/unenc/dist.cer'
+  keychain.import_private_key '../build/unenc/dist.p12', private_key_password
+
+  # Unlocking keychain (defaults to 1 hour) and adds keychain to user search list
+  keychain.unlock!
+  keychain.add_to_keychain_list!
+
+  # Building archive
+  xcodebuild(
+    clean: true,
+    archive: true,
+    archive_path: './build/YourApp.xcarchive',
+    workspace: ENV['WORKSPACE'],
+    scheme: ENV['SCHEME'],
+    configuration: 'Release',
+    sdk: 'iphoneos',
+    keychain: keychain.path
+    )
+
+  # Building IPA
+  xcodebuild(
+    export_archive: true,
+    export_path: './build/YourApp'
+    )
+
+  # Send to HockeyApp
+  hockey({
+    api_token: ENV['HOCKEYAPP_API_TOKEN'],
+  })
+
+  # Cleaning house again
+  sh "rm -rf ../circle/unenc"
+  keychain.remove_keychain_from_list!
+
+end
+```
+
 ## Using the internals
 
 ### Compiling and running the AppleScript directly

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: exportation
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Josh Holtz
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-23 00:00:00.000000000 Z
+date: 2015-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dotenv