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
The Terminal app can be found in: /Applications/Utilities
Navigate to the 'Provenance' directory with: cd [path]
(drag & drop a folder on Terminal after cd
to get directory path)
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:
git pull origin develop
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:
git stashgit reset --hard HEADgit pull origin developgit stash pop
Update submodules and frameworks
make updatemake open
Return to Xcode and…
Return to Build: Step 3 to reapply your settings, else…
If stashed changes above, just hit the ▶︎
(Run) button.
Provenance will compile and run on your device. Unless testing, hit ◼︎
(Stop). Done.
In Repositories
double-click Provenance
or select and click Open
With 'develop' branch marked (HEAD), click Fetch
If develop branch shows a number next to it, click Pull
Click Stash Changes
After changes are pulled, click Apply Stash
, select stash and click Apply Stash
In Terminal:
cd [path to Provenance]make updatemake open
Return to Xcode: Hit the ▶︎
(Run) button.
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.
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):
make ios
tvOS (Apple TV):
make tvos
🗯 If you are still stuck ask for help on our Discord.