Building

The following is documentation for those who would like to build and install the Zalf Mujadarra App.

Prerequisites

• XCode 14.1+ : download here
• an icloud account ie, someone@icloud.com (or the willingness to create one)
• an iOS Device with iOS 16.1.2+
• a lightning cable to plug it into your computer from where you are building from
• admin access to the computer you are working on

Building

1. Clone the zalf-mujadarra-xcode repo
2. Navigate to the project folder and open the .xcodeproj file
3. Focus on (select) the project root

1. Click ‘Signing & Capabilities’ > “automatically manage signing” > confirm > team > add an account

1. Add an account by clicking the ‘+’ button, button left

1. Sign in to your icloud account or create one if needed

1. Click ‘Manage Certificates…’

1. Add a new certificate by clicking on the ‘+’ button, bottom left

1. Click done

2. Plug your iOS Device in to to your computer and select it as a build target

1. Click the ‘play’ button

If you receive this pop-up message, simply autheticate with your computer’s password.
This is a security step so that others cannot sign an app with your certificate.

At this stage, XCode will build and install the app to your phone.
Note, it is normal to see a lot of ‘warning’ messages in the XCode UI.

1. You may get a pop up message in XCode directing you to unlock your device

1. Do so by entering your normal unlock code via your iOS Device.

The first time you run the app, you will receive a pop-up warning titled “Untrusted Developer” and also a pop-up in XCode itself.

This is expected and a normal security feature of iOS. Complete the following steps:

1. (As of iOS 16) on your iOS device, navigate to: settings > privacy & security and switch developer mode on
2. Then navigate to: settings > general > VPN & Device Management > Developer App (Heading) and trust your developer account

Now the App on your iOS device can be launched. Head back to the app and launch it like you would any other app.
At this point you can disconnect the iOS device from your computer. XCode will complain about it, but no functionality has been damaged. The app can now be run anywhere, any time.