Colendi WebView SDK

The Colendi Web View Software Development Kit.

Table of Content

• Overview
• Requirements
  • General Requirements
  • Permissions
• Installation
  • Via CocoaPods
• Integration
• Author
• LICENSE

Overview

The Colendi Web View is a Software Development Kit developed by Colendians to enable fast and simple integration to Colendi World.

Requirements

General Requirements

The minimum required iOS version for the SDK is:

• iOS 12.0 or higher

Permissions

Colendi WebView SDK makes use of the device Camera and NFC. You will be required to have the following keys in your application's Info.plist file:

    <key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
	<array>
		<string>A0000002471001</string>
	</array>
	<key>NFCReaderUsageDescription</key>
	<string>This application requires access to NFC to  scan IDs.</string>
	<key>NSCameraUsageDescription</key>
	<string>This application requires access to your camera for scanning and uploading the document.</string>

Note: All keys will be required for app submission.

Grant accesss to NFC

Enable the Near Field Communication Tag Reading capability in the target Signing & Capabilities.

Installation

Via-Cocoapods

ColendiWebView is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'ColendiWebViewSDK'

also add after last end statement of Podfile:

#add following lines end of podfile after last 'end'
post_install do |installer|     
  installer.pods_project.build_configurations.each do |config|
#if you have intel Mac you need to comment out following line 
    #config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
    installer.pods_project.targets.each do |target|
      target.build_configurations.each do |config|
        config.build_settings.delete 'IPHONEOS_DEPLOYMENT_TARGET'
        if target.name == 'lottie-ios'
          config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
        end
      end
    end
  end
end

Then, run the following command:

$ pod install

Integration

import UIKit
import ColendiWebViewSDK

class ViewController: UIViewController, ColendiWebViewDelegate {
    
    var colendiView: ColendiWebView?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        colendiView = ColendiWebView(frame: self.view.frame)
        colendiView?.setDelegate(delegate: self)

        /// Set insetsLayoutMarginsFromSafeArea false before loadUrl function to open ColendiWebView fullscreen.
        colendiView?.insetsLayoutMarginsFromSafeArea = false

        self.view.addSubview(self.colendiView!)

        //Change the 'URL' with colendi web app's url
        let url = URL(string: "URL")!
        
        colendiView?.loadUrl(url: url)
    }
    
    func messageCallback(message: String) {
        print(message)
    }
}

Optional Functions in ColendiWebViewDelegate

func decidePolicyForNavigationAction(decidePolicyFor navigationAction: WKNavigationAction, decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {}

func didReceiveAuthenticationChallenge(didReceive challenge: URLAuthenticationChallenge, completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {}

func didFailNavigation(didFail navigation: WKNavigation!, withError error: Error) {}

Author

Gökberk Bardakçı, Uygar İşiçelik from Colendi

License

ColendiWebView is available under the GNU GENERAL PUBLIC LICENSE license. See the LICENSE file for more info.