AdSedare

(from Latin "Ad Sedare" — to calm)

AdSedare is a Ruby library that makes iOS ad-hoc distribution smooth and stress-free. With AdSedare, you can stop dealing with the chaotic mess of:

• Manually adding every new tester device across countless ad-hoc profiles
• Keeping certificate capabilities and app group settings in sync
• Regenerating expired provisioning profiles one painful click at a time
• Writing clunky shell scripts to build keychains or install profiles from App Store
• Patching xcodeproj files to support ad-hoc builds, then reverting everything for production

AdSedare does all of this for you. It reads your Xcode project, understands its structure, and automates the entire profile and signing setup. It can even register new bundle IDs and request fresh provisioning profiles on the fly.

Why the Name?

The name AdSedare comes from personal suffering.

After over a year of managing internal iOS testing by hand, I was completely fried. I’d wrestled with Fastlane and similar tools, and while powerful, they were often too rigid or bloated for the very specific pain of ad-hoc distribution. So I built something with a single mission: Make internal iOS testing as chill as a cucumber in a snowstorm.

Docs

Right now, AdSedare is provided as a Ruby library, with plans to add CLI support later this year (™).

Adsedare::renew_profiles(project_path = nil, certificate_id = nil, team_id = nil)

This is the crown jewel of the library.

• Traverses all targets in your .xcodeproj
• Inspects capabilities and entitlements
• Creates or renews all necessary provisioning profiles
• Adds any missing test devices
• Works with APPLE_DEVELOPER_USERNAME and APPLE_DEVELOPER_PASSWORD (due to App Store Connect API being... gently nerfed into the ground)
• Handles 2FA with a scriptable interface — meaning you can hook in an SMS relay or similar system to auto-respond
• Stores sessions for up to ~2 weeks to avoid repeated logins

patch_project(project_path, team_id = nil)

Need to prep your Xcode project for ad-hoc builds? This does it cleanly:

• Fetches correct provisioning profile names

• Applies them to each target's PROVISIONING_PROFILE_SPECIFIER

• Optionally overwrites team_id if provided

• Does NOT use username/password — instead, expects:

  • APPSTORE_CONNECT_KEY_ID
  • APPSTORE_CONNECT_ISSUER_ID
  • APPSTORE_CONNECT_KEY

This makes it more CI-friendly and avoids the 2FA headache entirely.

install_profiles(project_path = nil)

• Downloads and installs all ad-hoc profiles needed by your project
• Places them in the correct location for Xcode to pick up
• Warns you if profiles are missing or expired
• Requires the same Connect API credentials as patch_project

create_keychain(keychain_path = nil, keychain_password = nil, make_default = true)

Arguably the second most powerful feature, built from many hours of trial, error, and mild mental anguish.

• Creates a dedicated build keychain
• Imports required certificate chains and partition settings
• If provided with AD_HOC_CERTIFICATE, AD_HOC_PRIVATE_KEY, and AD_HOC_KEY_PASSWORD, will add your ad-hoc distribution cert too

💡 This function deliberately does not pull certificates from App Store Connect (unlike match) — because:

• You can’t download private keys from Apple
• Recreating certs in CI constantly is a certified bad idea™
• Relying on third-party key storage wasn’t a hill I wanted to die on

make_export_options(project_path = nil, export_path = nil, team_id = nil, options = {})

Creates a ready-to-use exportOptions.plist:

• Automatically fills in correct profile names (fetched from App Store Connect)
• Adds sensible defaults
• Supports optional overrides like thinning, compileBitcode, etc.

Final Words

AdSedare isn’t here to replace Fastlane. But it is here to offer a lighter, simpler alternative for one very specific — but very common — pain: ad-hoc iOS testing.

It’s already running in production and saving devs real time and real headaches. If you find a bug or have an idea, feel free to open an issue or PR — I’ll be more than happy to help.