Provenance
Search
K

Updating

Update your existing installation.
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:

Pull

Update with Terminal

The Terminal app can be found in: /Applications/Utilities
  1. 1.
    Navigate to the 'Provenance' directory with: cd [path] (drag & drop a folder on Terminal after cd to get directory path)
  2. 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:
      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 stash
      git reset --hard HEAD
      git pull origin develop
      git stash pop
  3. 3.
    Update submodules and frameworks
    make update
    make open
  4. 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. 5.
    Provenance will compile and run on your device. Unless testing, hit ◼︎ (Stop). Done.

Update with Tower

  1. 1.
    In Repositories double-click Provenance or select and click Open
  2. 2.
    With 'develop' branch marked (HEAD), click Fetch
  3. 3.
    If develop branch shows a number next to it, click Pull
  4. 4.
    Click Stash Changes
  5. 5.
    After changes are pulled, click Apply Stash, select stash and click Apply Stash
  6. 6.
    In Terminal:
    cd [path to Provenance]
    make update
    make open
  7. 7.
    Return to Xcode: Hit the ▶︎ (Run) button.
  8. 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):
    make ios
  • tvOS (Apple TV):
    make tvos
🗯 If you are still stuck ask for help on our Discord.