Skip to content

Commit 4cb293f

Browse files
authored
update testflight.md, loopdocs links, generic instructions (#245)
* update testflight.md, loopdocs links, generic instructions * fix typos in testflight.md
1 parent f3021a5 commit 4cb293f

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

fastlane/testflight.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Using GitHub Actions + FastLane to deploy to TestFlight
22

3-
These instructions allow you to build Loop without having access to a Mac.
3+
These instructions allow you to build your app without having access to a Mac.
44

5-
* You can install Loop on phones using TestFlight that are not connected to your computer
5+
* You can install your app on phones using TestFlight that are not connected to your computer
66
* You can send builds and updates to those you care for
7-
* You can install Loop on your phone using only the TestFlight app if a phone was lost or the app is accidentally deleted
7+
* You can install your app on your phone using only the TestFlight app if a phone was lost or the app is accidentally deleted
88
* You do not need to worry about specific Xcode/Mac versions for a given iOS
99

1010
## **Automatic Builds**
@@ -26,14 +26,14 @@ These instructions allow you to build Loop without having access to a Mac.
2626

2727
The setup steps are somewhat involved, but nearly all are one time steps. Subsequent builds are trivial. Your app must be updated once every 90 days, but it's a simple click to make a new build and can be done from anywhere. The 90-day update is a TestFlight requirement, and with this version of Loop, the build process (once you've successfully built once) is automated to update and build at least once a month.
2828

29-
There are more detailed instructions in LoopDocs for using GitHub for Browser Builds of Loop, including troubleshooting and build errors. Please refer to:
29+
There are more detailed instructions in LoopDocs for using GitHub for Browser Builds, including troubleshooting and build errors. Please refer to:
3030

31-
* [LoopDocs: GitHub Overview](https://loopkit.github.io/loopdocs/gh-actions/gh-overview/)
32-
* [LoopDocs: GitHub Errors](https://loopkit.github.io/loopdocs/gh-actions/gh-errors/)
31+
* [LoopDocs: Browser Overview](https://loopkit.github.io/loopdocs/browser/bb-overview/)
32+
* [LoopDocs: Errors with Browser](https://loopkit.github.io/loopdocs/browser/bb-errors/)
3333

34-
Note that installing with TestFlight, (in the US), requires the Apple ID account holder to be 13 years or older. For younger Loopers, an adult must log into Media & Purchase on the child's phone to install Loop. More details on this can be found in [LoopDocs](https://loopkit.github.io/loopdocs/gh-actions/gh-deploy/#install-testflight-loop-for-child).
34+
Note that installing with TestFlight, (in the US), requires the Apple ID account holder to be 13 years or older. For younger Loopers, an adult must log into Media & Purchase on the child's phone to install Loop. More details on this can be found in [LoopDocs](https://loopkit.github.io/loopdocs/browser/phone-install/#testflight-for-a-child).
3535

36-
If you build multiple apps, it is strongly recommended that you configure a free *GitHub* organization and do all your building in the organization. This means you enter items one time for the organization (6 SECRETS required to build and 1 VARIABLE required to automatically update your certificates annually). Otherwise, those 6 SECRETS must be entered for every repository. Please refer to [LoopDocs: Use a *GitHub* Organization Account](https://loopkit.github.io/loopdocs/gh-actions/gh-other-apps/#use-a-github-organization-account).
36+
If you build multiple apps, it is strongly recommended that you configure a free *GitHub* organization and do all your building in the organization. This means you enter items one time for the organization (6 SECRETS required to build and 1 VARIABLE required to automatically update your certificates annually). Otherwise, those 6 SECRETS must be entered for every repository. Please refer to [LoopDocs: Create a *GitHub* Organization](https://loopkit.github.io/loopdocs/browser/secrets/#create-a-free-github-organization).
3737

3838
## Prerequisites
3939

@@ -43,14 +43,14 @@ If you build multiple apps, it is strongly recommended that you configure a free
4343

4444
## Save 6 Secrets
4545

46-
You require 6 Secrets (alphanumeric items) to use the GitHub build method and if you use the GitHub method to build more than Loop, e.g., Loop Follow or LoopCaregiver, you will use the same 6 Secrets for each app you build with this method. Each secret is indentified below by `ALL_CAPITAL_LETTER_NAMES`.
46+
You require 6 Secrets (alphanumeric items) to use the GitHub build method and if you use the GitHub method to build more than Loop, e.g., Loop Follow or LoopCaregiver, you will use the same 6 Secrets for each app you build with this method. Each secret is identified below by `ALL_CAPITAL_LETTER_NAMES`.
4747

4848
* Four Secrets are from your Apple Account
4949
* Two Secrets are from your GitHub account
5050
* Be sure to save the 6 Secrets in a text file using a text editor
5151
- Do **NOT** use a smart editor, which might auto-correct and change case, because these Secrets are case sensitive
5252

53-
Refer to [LoopDocs: Make a Secrets Reference File](https://loopkit.github.io/loopdocs/gh-actions/gh-first-time/#make-a-secrets-reference-file) for a handy template to use when saving your Secrets.
53+
Refer to [LoopDocs: Make a Secrets Reference File](https://loopkit.github.io/loopdocs/browser/intro-summary/#make-a-secrets-reference-file) for a handy template to use when saving your Secrets.
5454

5555
## Generate App Store Connect API Key
5656

@@ -100,7 +100,7 @@ A private Match-Secrets repository is automatically created under your GitHub us
100100
* `MATCH_PASSWORD`
101101
1. If you are using an organization, do this step at the organization level, e.g., username-org. If you are not using an organization, do this step at the repository level, e.g., username/LoopWorkspace:
102102
* Go to Settings -> Secrets and variables -> Actions and make sure the Variables tab is open
103-
1. Tap on "Create new organization variable" or "Create new repository variable", then add the name below and enter the value true. Unlike secrets variables are visible and can be edited.
103+
1. Tap on "Create new organization variable" or "Create new repository variable", then add the name below and enter the value true. Unlike secrets, variables are visible and can be edited.
104104
* `ENABLE_NUKE_CERTS`
105105

106106
## Validate repository secrets
@@ -124,11 +124,11 @@ There can be a delay after you start a workflow before the screen changes. Refre
124124

125125
## Create App Group
126126

127-
If you have already built Loop via Xcode using this Apple ID, you can skip on to [Add App Group to Bundle Identifiers](#add-app-group-to-bundle-identifiers).
127+
If you have already built Loop via Xcode using this Apple ID, you can skip ahead to [Add App Group to Bundle Identifiers](#add-app-group-to-bundle-identifiers).
128128

129-
1. Go to [Register an App Group](https://developer.apple.com/account/resources/identifiers/applicationGroup/add/) on the apple developer site.
129+
1. Go to [Register an App Group](https://developer.apple.com/account/resources/identifiers/applicationGroup/add/) on the Apple Developer site.
130130
1. For Description, use "Loop App Group".
131-
1. For Identifier, enter "group.com.TEAMID.loopkit.LoopGroup", subsituting your team id for `TEAMID`.
131+
1. For Identifier, enter "group.com.TEAMID.loopkit.LoopGroup", substituting your team id for `TEAMID`.
132132
1. Click "Continue" and then "Register".
133133

134134
## Add App Group to Bundle Identifiers
@@ -137,21 +137,21 @@ Note 1 - If you previously built with Xcode, the `Names` listed below may be dif
137137

138138
Note 2 - Depending on your build history, you may find some of the Identifiers are already configured - and you are just verifying the status; but in other cases, you will need to configure the Identifiers.
139139

140-
1. Go to [Certificates, Identifiers & Profiles](https://developer.apple.com/account/resources/identifiers/list) on the apple developer site.
140+
1. Go to [Certificates, Identifiers & Profiles](https://developer.apple.com/account/resources/identifiers/list) on the Apple Developer site.
141141
1. For each of the following identifier names:
142142
* Loop
143143
* Loop Intent Extension
144144
* Loop Status Extension
145145
* Loop Widget Extension
146146
1. Click on the identifier's name.
147-
1. On the "App Groups" capabilies, click on the "Configure" button.
147+
1. On the "App Groups" capabilities, click on the "Configure" button.
148148
1. Select the "Loop App Group"
149149
1. Click "Continue".
150150
1. Click "Save".
151151
1. Click "Confirm".
152152
1. Remember to do this for each of the identifiers above.
153153

154-
#### Table with Name and Identifier for Loop 3
154+
#### Table with Name and Identifier for Loop
155155

156156
| NAME | IDENTIFIER |
157157
|-------|------------|
@@ -197,7 +197,7 @@ Once a year, you will get an email from Apple indicating your certificate will e
197197

198198
## TestFlight and Deployment Details
199199

200-
Please refer to [LoopDocs: Set Up Users](https://loopkit.github.io/loopdocs/gh-actions/gh-first-time/#set-up-users-and-access-testflight) and [LoopDocs: Deploy](https://loopkit.github.io/loopdocs/gh-actions/gh-deploy/)
200+
Please refer to [LoopDocs: TestFlight Overview](https://loopkit.github.io/loopdocs/browser/tf-users) and [LoopDocs: Install on Phone](https://loopkit.github.io/loopdocs/browser/phone-install/)
201201

202202
## Automatic Build FAQs
203203

@@ -252,7 +252,7 @@ Note that the weekly and monthly Build Loop actions will continue, but the actio
252252

253253
### How to configure a variable
254254

255-
1. Go to the "Settings" tab of your LoopWorkspace repository.
255+
1. Go to the "Settings" tab of your repository (to modify a single repository schedule) or your organization to affect all repositories.
256256
2. Click on `Secrets and Variables`.
257257
3. Click on `Actions`
258258
4. You will now see a page titled *Actions secrets and variables*. Click on the `Variables` tab

0 commit comments

Comments
 (0)