This guide is written using Signal-iOS version 3.19.0
- Latest stable version of Xcode.
- Clone
Clone the repo to a working directory:
git clone --recurse-submodules https://github.com/signalapp/Signal-iOS
- Dependencies
To build and configure the libraries Signal uses, just run:
make dependencies
- Xcode
Open the Signal.xcworkspace in Xcode.
open Signal.xcworkspace
In the TARGETS area of the General tab, change the Team drop down to your own. You will need to do that for all the listed targets, for ex. Signal, SignalShareExtension, and SignalMessaging. You will need an Apple Developer account for this.
On the Capabilities tab, turn off Push Notifications and Data Protection, while keeping Background Modes on. The App Groups capability will need to remain on in order to access the shared data storage. The App ID needs to match the SignalApplicationGroup string set in TSConstants.h.
If you wish to test the Documents API, the iCloud capability will need to be on with the iCloud Documents option selected.
Build and Run and you are ready to go!