Updating

When there is a new release or recent commits to a source branch you have a few options for updating. You can sideload a prebuild over your existing sideloaded installation or you can pull the local source and build over your existing built-from-source installation. New: Update & Build via make (untested).
Update Options:
⤵️  Sideload****
🔃  Pull latest changes using…
​
  Terminal​
​
  Tower​
⏩  Update & Build****
Pull
Update with Terminal
The Terminal app can be found in: /Applications/Utilities
1.
Navigate to the 'Provenance' directory with: cd [path] (drag & drop a folder on Terminal after cd to get directory path)
2.
Update latest source (Options):
Overwrite Changes: If you haven't yet made any changes to source files or don't mind overwriting them and reapplying your Bundle IDs, App Groups from the original installation:
1
  git pull origin develop
Copied!
Stash Changes: If want to reapply your changes to source files (especially any PRs you are working on or simply your Bundle IDs App Groups), you will need to stash and re-apply them with:
1
  git stash
2
  git reset --hard HEAD
3
  git pull origin develop
4
  git stash pop
Copied!
3.
Update submodules and frameworks
1
 make update
2
 make open
Copied!
4.
Return to Xcode and…
Return to Build: Step 3 to reapply your settings, else…
If stashed changes above, just hit the ▶︎ (Run) button.
5.
Provenance will compile and run on your device. Unless testing, hit ◼︎ (Stop). Done.
Update with Tower
1.
In Repositories double-click Provenance or select and click Open
2.
With 'develop' branch marked (HEAD), click Fetch
3.
If develop branch shows a number next to it, click Pull
4.
Click Stash Changes
5.
After changes are pulled, click Apply Stash, select stash and click Apply Stash
6.
In Terminal:
1
 cd [path to Provenance]
2
 make update
3
 make open
Copied!
7.
Return to Xcode: Hit the ▶︎ (Run) button.
8.
Provenance will compile and run on your device. Unless testing, hit ◼︎ (Stop). Done.
To learn more about stashing refer to Tower's Using the Stash documentation.
Update & Build
If you've already done the First-time Setup, then you can build from the command-line using the following commands. These commands will pull any updates and build, so you can opt to update and build using only the terminal in the future.
iOS (iPhone, iPad):
1
  make ios
Copied!
tvOS (Apple TV):
1
  make tvos
Copied!
🗯 If you are still stuck ask for help on our Discord.

Building from Source

Next - Installation & Usage

BIOS Requirements

Last modified 11d ago

Copy link

Contents