MacFree iOS Builder for Unity to TestFlight

Publishing a Unity game to iOS normally requires a Mac. MacFree removes that requirement completely. It runs inside the Unity Editor on Windows, macOS, or Linux and hands every Mac-only step — building the Xcode project, code-signing, and uploading — to a cloud machine. The result lands in Apple TestFlight, ready to install on real devices.

HOW IT WORKS — THREE STEPS

Connect — paste your App Store Connect API key and a couple of IDs once.

Set Up — one click creates your iOS distribution certificate, provisioning profile, and cloud build configuration. No openssl, no Keychain, no Mac.

Build & Ship — one click builds, signs, and uploads to TestFlight in ~15–25 minutes.

Choose your build backend: the fully-automated GitHub Actions engine (no dashboards) or Unity Build Automation. Both reach the same TestFlight result.

MacFree stamps a fresh build number every time so Apple always accepts the upload, fixes common rejections before they cost build minutes (including Apple's opaque-icon requirement), and automatically uses the newest Xcode/SDK to satisfy Apple's current submission floor. Credentials are stored encrypted and are never committed to Git.

It is an Editor-only tool: it adds no runtime code to your game and works with every render pipeline (Built-in, URP, HDRP and custom SRPs).

REQUIREMENTS

MacFree automates Apple's build and delivery process. It cannot remove Apple's own account requirements, so please check this list before buying:

• Unity 6 or later WITH the iOS Build Support module installed (Unity Hub > Installs > Add Modules). The package uses UnityEditor.iOS.Xcode and will not compile without it.

• A paid Apple Developer Program membership (currently US$99/year) — Apple requires this for any iOS build, signing or TestFlight upload.

• An App Store Connect API key (.p8 file, Key ID and Issuer ID) with the App Manager role, plus your Apple Team ID.

• A Unity account. Unity Personal works.

• An app record already created in App Store Connect using the same bundle ID as your Unity project.

• An internet connection — the tool calls the App Store Connect, GitHub and/or Unity Cloud APIs on your behalf.

Then, depending on the backend you pick:

• GitHub Actions engine — a free GitHub account and a classic access token with the "repo" and "workflow" scopes. Builds use your GitHub Actions minutes; the free allowance covers typical use and any overage is billed by GitHub, not by this asset.

• Unity Build Automation engine — a Unity Cloud project with Build Automation enabled, plus one manual step: connecting your Git repository in the Unity Cloud dashboard (Unity offers no API for this). Build minutes are billed by Unity, not by this asset.

WHAT SETUP CREATES ON YOUR ACCOUNTS

So there are no surprises, the one-click setup will register your bundle ID with Apple if needed, create an iOS distribution certificate and App Store provisioning profile on your Apple Developer account (note that Apple limits how many distribution certificates a team may hold), and store your keys as encrypted secrets on your build service. On the GitHub Actions engine it also creates a private GitHub repository under your account and pushes your Unity project to it so the cloud runner can build it. Your credentials live in the project's UserSettings folder, which MacFree keeps out of Git.

INCLUDED THIRD-PARTY COMPONENTS

BouncyCastle.Crypto.dll (MIT) generates the signing key, CSR and .p12 — if your project already ships BouncyCastle from another asset, Unity may report a duplicate-assembly conflict; delete whichever copy you are not using. SimpleJSON (MIT) is used for JSON parsing. Both are credited in ThirdPartyNotices.txt.

GOOD TO KNOW

MacFree automates signing and delivery; it does not modify or port your game code. Build duration depends on project size (15–25 minutes is typical). Apple review outcomes and App Store policy remain entirely Apple's decision.

A full step-by-step PDF manual is included (Assets/MacFree/Documentation/MacFree-Manual.pdf). It walks through creating every account and key from scratch — assuming no prior experience with Apple Developer, GitHub or Unity Cloud — and includes troubleshooting.

Questions or problems: digiforcebusiness@gmail.com