Provenance
Search…
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.
    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.
Last modified 11d ago