esttorhe / sigh

Because you would rather spend your time building stuff than fighting provisioning

Home Page:http://felixkrause.at

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

DeliverSnapshotFrameItPEMSigh


Sigh

Because you would rather spend your time building stuff than fighting provisioning

Twitter: @KauseFx License Gem

Tired of manually creating, renewing and downloading your provisioning profiles?

sigh handles all that for you. Just run sigh and it will do the rest.

Follow the developer on Twitter: @KrauseFx


FeaturesInstallationUsageHow does it work?TipsNeed help?


Features

  • Download the latest provisioning profile for your app
  • Renew a provisioning profile, when it has expired
  • Repair a provisioning profile, when it is broken
  • Create a new provisioning profile, if it doesn't exist already
  • Supports App Store, Ad Hoc and Development profiles
  • Support for multiple Apple accounts, storing your credentials securely in the Keychain
  • Support for multiple Teams

Why not let Xcode do the work?

  • sigh can easily be integrated into your CI-server (e.g. Jenkins)
  • Xcode sometimes invalidates all existing profiles (Proof)
  • You have control over what happens
  • You still get to have the signing files, which you can then use for your build scripts or store in git

See sigh in action:

assets/sighRecording.gif

Installation

sudo gem install sigh

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

sigh

Yes, that's the whole command!

sigh will create, repair and download profiles for the App Store by default.

You can pass your bundle identifier and username like this:

sigh -a at.felixkrause.app -u username

If you want to generate an Ad Hoc profile instead of an App Store profile:

sigh --adhoc

If you want to generate a Development profile:

sigh --development

By default, sigh will install the downloaded profile on your machine. If you just want to generate the profile and skip the installation, use the following flag:

sigh --skip_install

Environment Variables

In case you prefer environment variables:

  • SIGH_USERNAME
  • SIGH_APP_IDENTIFIER
  • SIGH_TEAM_ID (The exact name of your preferred team for this account)

How does it work?

sigh will access the iOS Dev Center to download, renew or generate the .mobileprovision file. Check out the full source code: developer_center.rb.

How is my password stored?

sigh 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!
  • PEM: Tired of manually creating and maintaining your push certification profiles?

Use the 'Provisioning Quicklook plugin'

Download and install the Provisioning Plugin.

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

Need help?

  • If there is a technical problem with sigh, submit an issue. Run sigh --trace to get the stacktrace.
  • I'm available for contract work - drop me an email: sigh@felixkrause.at

License

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

Contributing

  1. Create an issue to start a discussion about your idea
  2. Fork it (https://github.com/KrauseFx/sigh/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

About

Because you would rather spend your time building stuff than fighting provisioning

http://felixkrause.at

License:MIT License


Languages

Language:Ruby 100.0%