Skip to content

Commit 5fc265a

Browse files
authored
Merge pull request #22 from loopandlearn/release_4.4
Update for changes with LoopFollow v4.4
2 parents ca4278a + be5558c commit 5fc265a

File tree

5 files changed

+93
-2664
lines changed

5 files changed

+93
-2664
lines changed

docs/build/build-options.md

Lines changed: 24 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -3,60 +3,11 @@
33
*LoopFollow* can be built using either the Browser Build or the Mac-Xcode Build method. A paid Apple Developer account is required to use the Browser Build method. Regardless of how you build, you can customize your *LoopFollow* app’s name.
44

55
* Browser Build:
6-
* If you have never built, see [LoopFollow Browser Build](lf-browser-build.md)
7-
* If you are a repeat builder, then you need a one-time update [Browser Build Update for *LoopFollow* v4.0](#browser-build-update-for-loopfollow-v40)
6+
* If you have never built, see [*LoopFollow* Browser Build](lf-browser-build.md)
7+
* If you are updating from v3.x or older, you need follow the one-time steps to [Update from *LoopFollow* v3.x](lf-browser-build.md#update-from-loopfollow-v3x){: target="_blank" }
88
* Mac-Xcode: [Build *LoopFollow* Script for Mac-Xcode](#build-loopfollow-script-for-mac-xcode)
99

10-
### Browser Build Update for *LoopFollow* v4.0
11-
12-
!!! important "New Capability with LoopFollow v4.0"
13-
A new capability was added to LoopFollow regarding remote commands which **requires a one-time update** to your LoopFollow **Identifier**. Browser Build will fail until you take these steps.
14-
15-
It doesn't matter whether the person you follow uses *Loop* or *Trio*. You have to update the Identifiers or the Browser Build will fail.
16-
17-
This requires you to follow these steps:
18-
19-
#### Sync Your *LoopFollow* fork
20-
21-
* Go to your *LoopFollow* fork and click on the Sync button
22-
* If your browser build already failed, it already did the sync for you
23-
24-
> ![sync the fork](img/github-build-check-fork-status.svg){width="700"}
25-
26-
#### Add Push Notifications Capability to LoopFollow Identifiers
27-
28-
You must manually enable the Push Notifications capabilty to the *LoopFollow* Identifier. Follow the directions below to open the Identifier and then keep scrolling down until you see Push Notifications. Make sure that check box is enabled, as shown in the graphic below. If you do not do this, the Build will fail.
29-
30-
The example graphic below has numbered steps that match these directions:
31-
32-
Click to open the [Certificates, Identifiers & Profiles: Identifiers List](https://developer.apple.com/account/resources/identifiers/list) page.
33-
34-
1. Locate the LoopFollow Identifer and click on it to open the `Edit your App ID Configuration` screen
35-
* The name in the **`NAME`** column may be different if you previously built with a Mac using Xcode, in that case it will start with XC
36-
2. Looking at the `Capabilities` column, scroll down to the `Push Notifications` row
37-
3. If the check box is not checked, you must check it
38-
4. Scroll back to the top and hit Save if you modified that value or All Identifiers if you made no changes
39-
40-
If you made a change and hit Save, you then need to Tap `Continue` and Tap `Save` to complete the process.
41-
42-
> ![graphic showing selection of the push notifications](img/add-push-notifications.svg){width="600"}
43-
44-
Repeat this step if you use LoopFollow_Second or LoopFollow_Third.
45-
46-
#### Run `Build LoopFollow`
47-
48-
1. Click on the Actions tab of your *LoopFollow* repository
49-
2. On the left side, click on `4. Build LoopFollow`
50-
3. On the right side, click Run Workflow to show a dropdown menu
51-
4. Tap the green button that says Run workflow.
52-
53-
> ![add identifiers](img/action-04-build.svg){width="700"}
54-
55-
**Once this completes, be sure to update from TestFlight to get the updated version of *LoopFollow* on your phone.**
56-
57-
Repeat the build and install from TestFlight steps if you use LoopFollow_Second or LoopFollow_Third.
58-
59-
### Build LoopFollow Script for Mac-Xcode
10+
### Build *LoopFollow* Script for Mac-Xcode
6011

6112
Carefully read the information in the terminal before making any choices.
6213

@@ -86,30 +37,40 @@ You are prompted to enter a custom name if you want or you can continue using th
8637

8738
To test a specific feature that is only found in the dev branch, choose option 4. This is not typical, and only builds to the app associated with Looper #1
8839

89-
### Run LoopFollow on Mac using TestFlight
40+
- - -
41+
42+
## Run *LoopFollow* on Mac
43+
44+
You can run *LoopFollow* on your Mac if you choose.
45+
46+
* [Run *LoopFollow* on Mac using TestFlight](#run-loopfollow-on-mac-using-testflight)
47+
* [Run *LoopFollow* on Mac with Mac-Xcode Build](#run-loopfollow-on-mac-with-mac-xcode-build)
48+
49+
50+
### Run *LoopFollow* on Mac using TestFlight
9051

91-
If you used the Browser Build method, follow these instructions to run LoopFollow on your Mac computer using TestFlight. (You can also use an iPad.)
52+
If you used the Browser Build method, follow these instructions to run *LoopFollow* on your Mac computer using TestFlight. (You can also use an iPad.)
9253

9354
* You need to install the TestFlight app on your computer
9455
* The TestFlight app on the Mac shows the same set of builds and uses the same installation procedure as shown in LoopDocs for installing apps on a phone from TestFlight
9556
* Install on computer from TestFlight
9657
* You need to enter the data source and configuration values into the app on your computer
9758

98-
From Mac system settings/notifications, scroll down to LoopFollow and enable notifications with the options you want.
59+
From Mac system settings/notifications, scroll down to *LoopFollow* and enable notifications with the options you want.
9960

100-
### Run LoopFollow on your Mac with Mac-Xcode Build
61+
### Run *LoopFollow* on Mac with Mac-Xcode Build
10162

102-
1. Build LoopFollow to your Mac with Xcode (choose My Mac (Mac Catalyst) as the device)
63+
1. Build *LoopFollow* to your Mac with Xcode (choose My Mac (Mac Catalyst) as the device)
10364
2. Click Stop to close the running app that is started by Xcode
10465
3. On the left side of Xcode, click on the Folder icon
105-
4. Click to open the LoopFollow folder list
106-
5. Click to open the LoopFollow/Products folder
66+
4. Click to open the *LoopFollow* folder list
67+
5. Click to open the *LoopFollow*/Products folder
10768
6. Right-click (or Control-click) on “LoopFollow.app” and select Show in Finder
10869
7. First time on the Mac:
10970
* Drag the LoopFollow.app icon to your Applications folder in Finder
110-
* From Mac system settings/notifications, scroll down to LoopFollow and enable notifications with the options you want
71+
* From Mac system settings/notifications, scroll down to *LoopFollow* and enable notifications with the options you want
11172
8. When updating on your Mac
112-
* Make sure you close the LoopFollow app currently running on your computer
73+
* Make sure you close the *LoopFollow* app currently running on your computer
11374
* Drag the LoopFollow.app icon to your Applications folder in Finder
11475
* Most people choose to replace the application, but you can keep both if you prefer
11576
* All configurations and settings are maintained
@@ -122,13 +83,13 @@ From Mac system settings/notifications, scroll down to LoopFollow and enable not
12283

12384
### Updates
12485

125-
When modifications and versions are updated, you might see activity at GitHub. Please wait for the release message to be posted at [LoopFollow Releases](https://github.com/loopandlearn/LoopFollow/releases) before using the updated versions for the `main` branch of LoopFollow, LoopFollow_Second and LoopFollow_Third.
86+
When modifications and versions are updated, you might see activity at GitHub. Please wait for the release message to be posted at [*LoopFollow* Releases](https://github.com/loopandlearn/LoopFollow/releases) before using the updated versions for the `main` branch of *LoopFollow*, *LoopFollow_Second* and *LoopFollow_Third*.
12687

12788
### Version Numbers
12889

12990
Updates to the `main` branch (releases) have a version number that ends in 0; for example, 3.1.0.
13091

13192
* Immediately following the release, the `dev` branch is at the same version as `main` indicating the code is identical
13293
* Each time a feature is merged into the `dev` branch, the final number increments; for example, 3.1.1, 3.1.2
133-
* When the next release is made, the second digit is incremented and the final digit is restore to 0 for both `main` and `dev`; for example, 3.2.0
94+
* When the next release is made, the second digit is incremented and the final digit is restored to 0 for both `main` and `dev`; for example, 3.2.0
13495

0 commit comments

Comments
 (0)