Build Open Source iOS MessengerEstimated reading time: 3 minutes
- 1: Preparation
- 2: Android App
- 3: iOS App
- 4: Customizing
- 5: Hosting Private APIs
- 6: On-Premise Deployment
- 7: Conclusion
In this part, we will download the source code for iOS Messenger, build and run it on a real iPhone device.
Ready? let’s get started.
Before we dive into building and running a fully featured Messenger for iOS, ensure that you’ve read the following.
- The first part of this tutorial and Prerequisites mentioned there.
- Get Started Guide.
- Tutorial on Writing your First mesibo Enabled Application
- XCode Installed
- An iPhone Device
Downloading the Source Code
The latest code for the iOS Messenger is always updated and pushed on messenger-app-ios repository.
There are multiple ways of “downloading” code from GitHub.
Clone the Repository (Recommended)
If you have git installed, this is a recommended approach as you can quickly sync and stay up to date with the latest version. This is also a preferred way of downloading the code if you decide to contribute to the project.
To download, open a terminal and issue following commands:
$ mkdir Messenger $ cd Messenger $ git lfs install $ git clone https://github.com/mesibo/messenger-app-ios.git
Download the code as a zip file
You can also download the complete iOS Messenger source code as a zip file. Although simple, the downside of this approach is that you will have to download the complete source code every time it is updated on the repository.
Click on the
Download button to start downloading.
Once the download completes, unzip into a folder.
WARNING! zip file will be quite large due to the inclusion of bitcode enabled frameworks.
git cloneis the recommended approach.
Whatever approach you take to download the code, it is important to stay up-to-date with the latest changes, new features, fixes, etc. Ensure to Star(*) the project on GitHub to get notified whenever the source code is updated.
Build and Run
In this part, we will build the code as it is and run the app. In the next section we will learn about customizing.
Building the code is as simple as:
- Launch Xcode
- Open the project from the folder where you have downloaded the code using the menu
File -> Open
- Build using menu
Product -> Build
- It may take a while to build the project for the first time.
- Once the build is over, run on the device using the menu
Product -> Run
- That’s it, you should see the welcome screen like below.
Log in using your phone number. You can even start using the app you’ve just built to communicate with your family and friends. Cool isn’t it?
If you receive linker errors
If you receive linker errors, it means that your download was incomplete. One of the likely reasons is that you forgot to issue
git lfs install. There are two ways to fix:
- Delete the entire repository and download again (do not forget
git lfs install, as instructed above). Note that enabling
git lfs installafter partial download does not seem to work as expected.
- OR, run
Conclusion of part three
In this part, we have built and run the iOS Messenger app.
In part 4, we will learn about customizing applications.open, source, whatsapp, mesibo, ios, overview