“SBurK” Documentation v1.3

“iOS Apps for Parents and Drivers”

What is SBurK?
Driver App
Parent App
In app purchases setup
FAQ

A) What is SBurK? - top

SBurK is a comprehensive system for school bus tracking that manages the daily school bus operation. SBurK comes in two packages: basic and extended. The basic package consists of three sub systems, which are

Laravel admin web panel
Android mobile app for parents
Android mobile app for drivers

The extended package has the contents of the basic one plus the following

iOS mobile app for parents
iOS mobile app for drivers

Here we present the iOS mobile apps for parents and drivers

Please setup the backend first, then the mobile apps.

B) Driver App - top

In order to build the iOS app for drivers correctly, please make sure that

You have accounts for Google maps SDK with iOS SDK enabled.

You have XCode 12.4 installed.

You have cocoapods installed. You can install it by writing
sudo gem install cocoapods
in your terminal

Follow the following steps

Open a new terminal

Go to the location of the purchased "SchoolBusDriver" folder

            cd /to/location/of/SchoolBusDriver/folder

write
```
            pod install
        
```
Find the generated "SchoolBusDriver.xcworkspace" file and open it with XCode 12.4
In the left pane, select the project "SchoolBusDriver"
Under Signing & Capabilities sign in with your Apple ID

In the left pane, open "Util.swift" file
Change the value for the variable "WEB_SERVER_URL" with your backend url
Change the value for the variable "GOOGLE_MAPS_API_KEY" with your Google maps api key

Optional: Change the default country code of driver telephone number by changing the line #36 in LoginViewController.swift file

            phoneNumberTextField.setFlag(key: .US)

Optional: If your web server is not secure, i.e., http not https, then you need to write the follwing in your info.plist and change "WEB_SERVER_URL"

            <key>NSAppTransportSecurity</key>
            <dict>
                <key>NSAllowsArbitraryLoads</key>
                <true/>
                <key>NSExceptionDomains</key>
                <dict>
                    <key>WEB_SERVER_URL</key>
                    <dict>
                        <key>NSExceptionAllowsInsecureHTTPLoads</key>
                        <true/>
                        <key>NSIncludesSubdomains</key>
                        <true/>
                    </dict>
                </dict>
            </dict>

Build the workspace

C) Parent App - top

In order to build the iOS app for parents correctly, please make sure that

You have accounts for

Paid Apple developer account

Google maps SDK

Firebase Cloud Messaging

You have XCode 12.4 installed.

You have cocoapods installed. You can install it by writing
sudo gem install cocoapods
in your terminal

Follow the following steps

Open a new terminal
Go to the location of the purchased "SchoolBusTracker" folder
```
cd /to/location/of/SchoolBusTracker/folder
```
write
```
pod install
```
Find the generated "SchoolBusTracker.xcworkspace" file and open it with XCode 12.4
In the left pane, select the project "SchoolBusTracker"
Under Signing & Capabilities sign in with your Apple ID

In the left pane, open "Util.swift" file
Change the value for the variable "WEB_SERVER_URL" with your backend url
Change the value for the variable "WEB_SOCKET_SERVER_HOST" with your laravel-echo-server url
Change the value for the variable "WEB_SOCKET_SERVER_PORT" with your laravel-echo-server port number
Change the value for the variable "GOOGLE_MAPS_API_KEY" with your Google maps api key
Please follow the steps here to configure the push notifications correctly.

Go to your fire base account
Add new project and name it "SBurK", if you do not perform this step when you install the backend

Click on the iOS icon to add Firebase to your iOS app

Fill out the app information in the displayed form
Click on "Register app"
Click on "Download GoogleService-Info.plist" and save it inside the folder "SchoolBusTracker
Right click on the SchoolBusTracker Folder in the left pane of Xcode, and choose add files to SchoolBusTracker. Then choose "GoogleService-Info.plist" file.
Optional: Change the default country code of driver telephone number by changing the line #36 in LoginViewController.swift file

            phoneNumberTextField.setFlag(key: .US)

Optional: If your web server is not secure, i.e., http not https, then you need to write the follwing in your info.plist and change "WEB_SERVER_URL"

            <key>NSAppTransportSecurity</key>
            <dict>
                <key>NSAllowsArbitraryLoads</key>
                <true/>
                <key>NSExceptionDomains</key>
                <dict>
                    <key>WEB_SERVER_URL</key>
                    <dict>
                        <key>NSExceptionAllowsInsecureHTTPLoads</key>
                        <true/>
                        <key>NSIncludesSubdomains</key>
                        <true/>
                    </dict>
                </dict>
            </dict>

Build the workspace

D) In app purchases setup - top

Firstly, you must choose from the teirs of in app purchases (you can choose as many as you want): https://warehouse.leapmotion.com/price_tiers
Open xcode and right click the xcodeproject, and select New file
Select storekit configuration
Add Consumable Products from the + sign

Type in the following:

Refrence name: A name the user will see when they make the in app purchase

Product Identifier: A unique identifier for the product. This should be formatted as follows:

                    com.yourcompany.app.product_name

Price: The price of the product

Go to Product > Scheme > Edit Scheme and in Run/Debug tab under Options choose your StoreKit configuration file.
After uploading the app, open app store connect, and choose your app
Open the in app purchases tab and click App-specific Shared Secret

Copy the secret and paste it into the ITUNES_PASSWORD variable in the .env
Click on the plus sign to add a product
Register all your products, with the same product ids and prices in the Configuration file
Once you are finished, open up the superadmin dashboard and navigate to IOS Products
Click on "New product" to add a product

Register all your products, with the same product ids and prices in the Configuration file and app store connect
You're all set!

E) FAQ - top

Which versions of iOS both the driver and parent apps works with?

The driver and parent apps works with iOS version 10.0 or greater

How to change the share message of the driver and parent apps?

Edit the strings file in the path "AppStrings/en.lproj/Localizable.strings" at the tag

    "share_body" = "your share message";

Notifications not working

Make sure that you installed the "GoogleService-Info.plist" file in the path "SchoolBusTracker"

The school bus icon is not moving while the driver changes his location

Make sure that the laravel-echo-server is working correctly. Go to the url of your admin panel and append it with 6001, i.e., open http://www.yourdomain.com:6001 and check if it gives OK

The parent app does not continue after entering the correct verification code

Make sure that you install the Firebase cloud messaging correctly by adding "GoogleService-Info.plist" file. The app needs a token from the Firebase and will not continue to the main screen until this token is obtained.

Once again, thank you so much for using SBurK. As I said at the beginning, I'd be glad to help you if you have any questions. I'll do my best to assist. If you have a more general question relating to the items on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.

CreativeAppsDev Team

Go To Table of Contents