You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: fastlane/testflight.md
+30-27Lines changed: 30 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ These instructions allow you to build Loop without having access to a Mac. They
4
4
5
5
The setup steps are somewhat involved, but nearly all are one time steps. Subsequent builds are trivial.
6
6
7
-
## Prerequisites.
7
+
## Prerequisites
8
8
9
9
* 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.
10
10
* 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
13
13
14
14
## Generate App Store Connect API Key
15
15
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`.
22
22
23
23
## Setup Github
24
24
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
27
27
* Enter a name for your token. Something like "FastLane Access Token".
28
28
* 30 days is fine, or you can select longer if you'd like.
29
29
* 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.
33
33
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:
34
34
*`TEAMID`
35
35
*`FASTLANE_KEY_ID`
@@ -41,17 +41,18 @@ The setup steps are somewhat involved, but nearly all are one time steps. Subseq
41
41
## Add Identifiers for Loop App
42
42
43
43
1. Click on the "Actions" tab of your LoopWorkspace repository.
44
-
1. Select "Add Identifiers"
44
+
1. Select "Add Identifiers".
45
45
1. Click "Run Workflow", and tap the green button.
46
46
1. Wait, and within a minute or two you should see a green checkmark indicating the workflow succeeded.
47
47
48
48
## Create App Group
49
49
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
+
51
52
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".
55
56
56
57
## Add App Group to Bundle Identifiers
57
58
@@ -79,31 +80,33 @@ The setup steps are somewhat involved, but nearly all are one time steps. Subseq
79
80
80
81
## Create Loop App in App Store Connect
81
82
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
+
83
85
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".
85
87
* 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.
87
89
* 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.
92
95
93
96
## Create Building Certficates
94
97
95
98
1. Go back to the "Actions" tab of your LoopWorkspace repository in github.
96
-
1. Select "Create Certificates"
99
+
1. Select "Create Certificates".
97
100
1. Click "Run Workflow", and tap the green button.
98
101
1. Wait, and within a minute or two you should see a green checkmark indicating the workflow succeeded.
99
102
100
103
## Build Loop!
101
104
102
105
1. Click on the "Actions" tab of your LoopWorkspace repository.
103
-
1. Select "Build Loop"
106
+
1. Select "Build Loop".
104
107
1. Click "Run Workflow", select your branch, and tap the green button.
105
108
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.
109
112
* Add them to your TestFlight Internal Testing group.
0 commit comments