Deliver • Snapshot • FrameIt • PEM • Sigh

Pem - Maintain your push certificates

Twitter: @KauseFx License Gem

Tired of manually creating and maintaining your push notification profiles for your iOS apps? Tired of generating a pem file for your server?

PEM does all that for, just by running pem.

To automate iOS Provisioning profiles you can use sigh.

Felix Krause (@KrauseFx) the developer of PEM
Sebastian Mayr (@sebmasterkde) who implemented the download mechanism of signing certificates
Alexander Schuch (@schuchalexander) who automated the generation of the signing request

Features • Installation • Usage • How does it work? • Tips • Need help?

Features

Well, it's actually just one: Generate the pem file for your server.

Check out this gif:

assets/PEMRecording.gif

Installation

sudo gem install pem

Make sure, you have the latest version of the Xcode command line tools installed:

xcode-select --install

Install phantomjs (this is needed to control the Apple Developer Portal)

brew update && brew install phantomjs

If you don't already have homebrew installed, install it here.

Usage

pem

Yes, that's the whole command!

This does the following:

  • Create a new signing request
  • Create a new push certification
  • Downloads the certificate
  • Generates a new .pem file in the current working directory, which you can upload to your server

PEM will never revoke your existing certificates.

You can pass parameters like this:

pem -a at.felixkrause.app -u username

If you want to generate a development certificate instead:

pem --development

Environment Variables

In case you prefer environment variables:

  • PEM_USERNAME
  • PEM_APP_IDENTIFIER
  • PEM_TEAM_ID

How does it work?

There are 2 actions involved:

  • Accessing the iOS Dev Center to download the latest aps_production.cer. See: developer_center.rb.
  • Generating all the necessary profiles and files to prepare the finished .pem file. See: cert_manager.rb.
  • The .certSigningRequest file will be generated in signing_request.rb

How is my password stored?

PEM uses the password manager from Deliver. Take a look the Deliver README for more information.

Tips

Other helpful tools

Check out other tools in this collection to speed up your deployment process:

  • deliver: Deploy screenshots, app metadata and app updates to the App Store using just one command
  • snapshot: Create hundreds of screenshots of your iPhone app... while doing something else
  • FrameIt: Want a device frame around your screenshot? Do it in an instant!
  • sigh: Because you would rather spend your time building stuff than fighting provisioning

Use the 'Provisioning Quicklook plugin'

Download and install the Provisioning Plugin.

It will show you the pem files like this: assets/QuickLookScreenshot.png

Need help?

  • If there is a technical problem with PEM, submit an issue. Run pem --trace to get the stacktrace.
  • I'm available for contract work - drop me an email: [email protected]

License

This project is licensed under the terms of the MIT license. See the LICENSE file.

Contributing

  1. Create an issue to discuss about your idea
  2. Fork it (https://github.com/KrauseFx/pem/fork)
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request