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:

• ⤵️ 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:

       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. Update submodules and frameworks

    make update
    make open

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:

    cd [path to Provenance]
    make update
    make open

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):

    make ios

• tvOS (Apple TV):

    make tvos

🗯 If you are still stuck ask for help on our Discord.