Installation
- Make sure you have Xcode 9 as the app is now written in Swift 4
- Clone the repository:
git clone git@github.com:balancemymoney/balance-open.git - Open the project in Xcode
- Disable signing for debug builds or alternatively change the app bundle ID and sign with your developer account
- Build and run from Xcode
Updating dependencies
We use carthage for dependency management, however we check in all built frameworks, so it is not necessary to run any carthage commands.
However, if moving to a new Swift version, or for other reasons, it may be necessary to rebuild them using carthage update --platform "osx, ios".
The easiest way to install Carthage is to install Homebrew by running /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" and then run brew install carthage.
If you already have Homebrew installed, make sure to run brew update && brew upgrade first to to make sure you have the latest version of Carthage.
If for some reason the sqlcipher needs to be updated (you should never need to do this), run the build_sqlcipher script in the root of this repository and then move the libsqlcipher.a file that it creates on your desktop to the ./Balance/Shared/Frameworks/ folder.
Contributing
- If you need help or you'd like to ask a general question, open an issue.
- If you found a bug, open an issue.
- If you have a feature request, comment, upvote or create a new Trello card.
- If you want to contribute, submit a pull request.
- Extra: If you choose to build with debug code signing disabled, since we use keychain you will be prompted on this screen at least once for every exchange you have connected. You should press "Always allow", though after about a minute or so it will forget the choice and prompt again on the next run. We haven't found a better way to do this yet.