Social Documentation

Thank you for purchasing our Social source code for iOS written in Swift!

There are just a few initial steps you’ll need to go through to get your backend setup (mainly this is just the database part for which we’ll use Google Firebase)

 

1. Firebase Setup

a. Head over to https://firebase.google.com/ and click on the big ‘Get Started’ button
b. You’ll need to create a Gmail account if you don’t already have one, otherwise just log in with your preferred account
c. Once you’re logged in, you’ll see the ‘Firebase Console’, you need to click ‘Add Project’
d. Choose a name for your project (generally this is the app name), go through the next couple of steps and your project will be created
e. Once your project is setup, you’ll be taken to your Firebase Console, this is the main admin dashboard for your backend where you can manage things such as the database, file storage, user authentification and much more
f. Now we need to add the Firebase configuration file to the app, so our app can talk to Firebase effectively. So on the main page of your Firebase Console, click ‘iOS’ and you’ll be taken to the ‘Add Firebase to your iOS app’ page
g. Fill in the fields with your apps bundle ID (by default, for Social this is “com.Social” without the quotation marks)
h. Download the “GoogleService-Info.plist” file and save it to your computer, then drag this file into your project’s ‘Supporting Files’ folder
i. Next you’ll shown how to add the Firebase SDK to your project – but we’ve already done this for you so you can skip this step.
j. Make sure you open the ‘xcworkspace’ file to view the project in xCode, and not the ‘xcodeproj’ file. This is because we’ve already set up the project with Cocoapods to manage the third party dependencies used in the app

 

Troubleshooting:

If you experience issues building the app for the first time even after you’ve been through the above steps to integrate in with Firebase then it’s possible that the Cocoapods installation has been corrupt so just delete the ‘xcworkspace’ file (keep the other files, such as the podfile in particular) then open up Terminal on your mac, then ‘cd’ to the folder where the project file is saved then run ‘pod install’

If Terminal tells you that ‘POD’ is an unrecognised command then you don’t have Cocoapods installed. So just Google how to do this, it’s fairly straightforward and can be done in just a few steps. Once installed, run that ‘pod install’ command again and it will add the ‘xcworkspace’ file back to the folder. Open it and try to build the app again

If you’re still encountering issues with the initial Firebase setup or building the app before you’ve made any changes to the code then please email us so we can help: info@apperfect.london