Demo Mobile App

The demo mobile app allows you to try an actual implementation of the Mobile SDK within a mobile app. The SDK gives you the flexibility to develop any experience, even handling the entire enrollment process in the background.

The mobile app is called FogSpot Connect and it is available for IOs and Android. The app is not public on the app store, so once you make a request, our team will contact you with further instructions to download the app.

1. Setting up the network

The Mobile App uses Cloud4Wi SDK and it requires a dedicated SSID on the WiFi network configured with the proper settings. Note that you need to add an additional dedicated SSID on top of those that you already have. For the scope of this demo, the SSID name must be "securewifi.io".

Depending on the WiFi vendor used, you might need to set the same value in different configuration interfaces. The configuration steps vary depending on the WiFi vendor. Here you can find the configuration guide for Cisco Meraki. If you are using other WiFi vendors, please contact our team and we'll send you the related instructions.

You also need to insert the Access Point identifier in your Cloud4Wi Account. The value to use as MAC Address / NAS-ID depends on the specific WiFi vendor as detailed in the related configuration guide.

2. Downloading the Mobile App

The app is currently in beta mode, so we need to send you an invitation as a tester to download it from the app stores.

3. Setting up the mobile app

Once we have enabled your Cloud4Wi account, we'll send you an Application Token to authenticate your app. Open the app > Settings and paste the Application Token in the related field.

In the same Setting screen, select "WPA2-Enterprise" as WiFi Profile Type.

4. Using the Mobile App

The mobile app experience has been designed to emulate the scenario where the user must register explicitly to the service. In your mobile app, you can use the SDK methods to run this step in the background without user intervention.

Open the Register page form the side menu, fill in the form and submit to create the user profile. If you already have an account, you can simply log in from the Login page. You'll receive a message confirming that the setup has been completed.

At this point, your mobile is enabled and will connect and authenticate automatically to the SSID created above whenever in range.

Test details

If there are other WiFi networks in range that are known and your device has already saved their credentials, the device might prefer those networks instead of the new secure network.

For testing purpose only, we suggest removing from your phone all the known WiFi networks.

Demo App Source Code


If you want to create your own version of the demo mobile app, you can download the source code and personalize it.

The codebase already embed the Mobile SDK.

Download it here.

(the zip file is password protected. Contact our team to receive the password)

Instructions

Prerequisites:

   - git
   - node
   - npm

   For Android app:
   - Android Studio

   For iOS app:
   - cocoapods
   - Xcode

You need to do following steps in order to customize MobileSDKAppTermplate:

  1. Clone project from GitHab:

git clone https://link-to-repository

   2. Go to project directory:


cd mobilesdk-app-template

   3. Install Node dependencies (may take up to 5 minutes):


npm install

  4. In case you want to build app for iOS you need to install pods (optional):


cd ios 
pod install
cd ../

 

  1. Edit React Native source code. You can find source files under 'src' directory.
  2. Run your customized application on emulator or on your device:

Run iOS version:


npx react-native run-ios

Run Android version:


npx react-native run-android

NOTE: in order to run iOS version of customized app on real device you need to configure 'development team' in 'Signing & Capabilities'.

IMPORTANT: MobileSDK features as Wi-Fi profile installation is not available on iOS and Android emulators.
While account registration and sign-in can be tested in emulator, Wi-Fi profile installation need to be tested on real device.