Skip to content

Commit 5291d51

Browse files
authored
Update testflight.md
1 parent 64ef510 commit 5291d51

File tree

1 file changed

+30
-27
lines changed

1 file changed

+30
-27
lines changed

fastlane/testflight.md

Lines changed: 30 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ These instructions allow you to build Loop without having access to a Mac. They
44

55
The setup steps are somewhat involved, but nearly all are one time steps. Subsequent builds are trivial.
66

7-
## Prerequisites.
7+
## Prerequisites
88

99
* A [github account](https://github.com/signup). The free level comes with plenty of storage and free compute time to build loop, multiple times a day, if you wanted to.
1010
* A paid [Apple Developer account](https://developer.apple.com). You may be able to use the free version, but that has not been tested.
@@ -13,12 +13,12 @@ The setup steps are somewhat involved, but nearly all are one time steps. Subseq
1313

1414
## Generate App Store Connect API Key
1515

16-
1. Sign in to the [Apple developer portal page](https://developer.apple.com/account/resources/certificates/list)
17-
1. Copy the team id from the upper right of the screen. Record this as your `TEAMID`
18-
1. Go to the [App Store Connect](https://appstoreconnect.apple.com/access/api) interface, click the "Keys" tab, and create a new key with "Admin" access. Give it a name like "FastLane API Key"
19-
1. Record the key id; this will be used for `FASTLANE_KEY_ID`
20-
1. Record the issuer id; this will be used for `FASTLANE_ISSUER_ID`
21-
1. Download the API key itself, and open it in a text editor. The contents of this file will be used for `FASTLANE_KEY`
16+
1. Sign in to the [Apple developer portal page](https://developer.apple.com/account/resources/certificates/list).
17+
1. Copy the team id from the upper right of the screen. Record this as your `TEAMID`.
18+
1. Go to the [App Store Connect](https://appstoreconnect.apple.com/access/api) interface, click the "Keys" tab, and create a new key with "Admin" access. Give it a name like "FastLane API Key".
19+
1. Record the key id; this will be used for `FASTLANE_KEY_ID`.
20+
1. Record the issuer id; this will be used for `FASTLANE_ISSUER_ID`.
21+
1. Download the API key itself, and open it in a text editor. The contents of this file will be used for `FASTLANE_KEY`.
2222

2323
## Setup Github
2424
1. Create a [new empty repository](https://github.com/new) titled `Match-Secrets`. It should be private.
@@ -27,9 +27,9 @@ The setup steps are somewhat involved, but nearly all are one time steps. Subseq
2727
* Enter a name for your token. Something like "FastLane Access Token".
2828
* 30 days is fine, or you can select longer if you'd like.
2929
* Select the `repo` permission scope.
30-
* Click "Generate token"
31-
* Copy the token and record it. It will be used below as `GH_PAT`
32-
1. In the forked LoopWorkspace repo, go to Settings -> Secrets -> Actions
30+
* Click "Generate token".
31+
* Copy the token and record it. It will be used below as `GH_PAT`.
32+
1. In the forked LoopWorkspace repo, go to Settings -> Secrets -> Actions.
3333
1. For each of the following secrets, tap on "New repository secret", then add the name of the secret, along with the value you recorded for it:
3434
* `TEAMID`
3535
* `FASTLANE_KEY_ID`
@@ -41,17 +41,18 @@ The setup steps are somewhat involved, but nearly all are one time steps. Subseq
4141
## Add Identifiers for Loop App
4242

4343
1. Click on the "Actions" tab of your LoopWorkspace repository.
44-
1. Select "Add Identifiers"
44+
1. Select "Add Identifiers".
4545
1. Click "Run Workflow", and tap the green button.
4646
1. Wait, and within a minute or two you should see a green checkmark indicating the workflow succeeded.
4747

4848
## Create App Group
4949

50-
1. If you have already built Loop via Xcode using this Apple ID, you can skip on to [Create Loop App in App Store Connect](#create-loop-app-in-app-store-connect).
50+
If you have already built Loop via Xcode using this Apple ID, you can skip on to [Create Loop App in App Store Connect](#create-loop-app-in-app-store-connect).
51+
5152
1. Go to [Register an App Group](https://developer.apple.com/account/resources/identifiers/applicationGroup/add/) on the apple developer site.
52-
1. For Description, use "Loop App Group"
53-
1. For Identifier, enter "group.com.TEAMID.loopkit.LoopGroup", subsituting your team id for `TEAMID`
54-
1. Click "Continue" and then "Register"
53+
1. For Description, use "Loop App Group".
54+
1. For Identifier, enter "group.com.TEAMID.loopkit.LoopGroup", subsituting your team id for `TEAMID`.
55+
1. Click "Continue" and then "Register".
5556

5657
## Add App Group to Bundle Identifiers
5758

@@ -79,31 +80,33 @@ The setup steps are somewhat involved, but nearly all are one time steps. Subseq
7980

8081
## Create Loop App in App Store Connect
8182

82-
1. If you have created a Loop app in App Store Connect before, you can skip this section as well.
83+
If you have created a Loop app in App Store Connect before, you can skip this section as well.
84+
8385
1. Go to the [apps list](https://appstoreconnect.apple.com/apps) on App Store Connect and click the blue "plus" icon to create a New App.
84-
* Select "iOS"
86+
* Select "iOS".
8587
* Select a name: this will have to be unique, so you may have to try a few different names here, but it will not be the name you see on your phone, so it's not that important.
86-
* Select your primary language
88+
* Select your primary language.
8789
* Choose the bundle ID that matches `com.TEAMID.loopkit.Loop`, with TEAMID matching your team id.
88-
* SKU can be anything; e.g. "123"
89-
* Select "Full Access"
90-
* Click Create
91-
* You do not need to fill out the next form. That is for submitting to the app store.
90+
* SKU can be anything; e.g. "123".
91+
* Select "Full Access".
92+
1. Click Create
93+
94+
You do not need to fill out the next form. That is for submitting to the app store.
9295

9396
## Create Building Certficates
9497

9598
1. Go back to the "Actions" tab of your LoopWorkspace repository in github.
96-
1. Select "Create Certificates"
99+
1. Select "Create Certificates".
97100
1. Click "Run Workflow", and tap the green button.
98101
1. Wait, and within a minute or two you should see a green checkmark indicating the workflow succeeded.
99102

100103
## Build Loop!
101104

102105
1. Click on the "Actions" tab of your LoopWorkspace repository.
103-
1. Select "Build Loop"
106+
1. Select "Build Loop".
104107
1. Click "Run Workflow", select your branch, and tap the green button.
105108
1. You have some time now. Go enjoy a coffee. The build should take about 20-30 minutes.
106-
1. Your app should eventually appear on [App Store Connect](https://appstoreconnect.apple.com/apps)
107-
1. For each phone/person you would like to support Loop on
108-
* Add them in [Users and Access](https://appstoreconnect.apple.com/access/users) on App Store Connect
109+
1. Your app should eventually appear on [App Store Connect](https://appstoreconnect.apple.com/apps).
110+
1. For each phone/person you would like to support Loop on:
111+
* Add them in [Users and Access](https://appstoreconnect.apple.com/access/users) on App Store Connect.
109112
* Add them to your TestFlight Internal Testing group.

0 commit comments

Comments
 (0)