https://github.com/socketmobile/cocoapods-maraca
https://github.com/socketmobile/cocoapods-maraca
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/socketmobile/cocoapods-maraca
- Owner: SocketMobile
- License: mit
- Created: 2022-09-29T10:41:20.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-06-13T13:16:08.000Z (almost 2 years ago)
- Last Synced: 2025-02-25T14:55:47.463Z (2 months ago)
- Language: Swift
- Size: 45.9 KB
- Stars: 0
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Maraca Version 1.0.10 - Cocoapods
Maraca establishes connections between your iOS application using our [iOS CaptureSDK](https://github.com/SocketMobile/cocoapods-capturesdk) and a web application using our [CaptureJS SDK](https://docs.socketmobile.com/capturejs/en/latest/gettingStarted.html). This enables the web application to connect with our scanners and NFC readers with the same flexibilty that our iOS SDK provides.
## Usage
Under the hood, Maraca is an umbrella for our iOS Capture SDK. So naturally, you need to provide credentials to get started.
The most important step is to call `observeJavascriptMessageHandlers(_:)`
You may provide your own Javascript Message Handler names if you're familiar with [WKUserContentController](https://developer.apple.com/documentation/webkit/wkusercontentcontroller). Otherwise, this can be nil.
This function enables messages containing data to be transferred from your web application using CaptureJS to your iOS application.
Inside the completion handler of `beging(withAppKey:appId:developerId:completion:)`, create your `WKWebView` using the public `Maraca.shared.webViewConfiguration` configuration
```swift
override func viewDidLoad() {
super.viewDidLoad()
setupMaraca()
}
private func setupMaraca() {
let appKey =
let appId =
let developerId =
let bundle = Bundle.main
Maraca.shared.injectCustomJavascript(mainBundle: bundle, javascriptFileNames: ["getInputForDecodedData"])
.observeJavascriptMessageHandlers(YourOwnMessageHandlers.allCases.map { $0.rawValue })
.setDelegate(to: self)
.begin(withAppKey: appKey,
appId: appId,
developerId: developerId,
completion: { [weak self] (result) in
if result == .E_NOERROR {
self?.setupUI()
} else {
// Encountered some error, inspect result
}
})
}
// Initialize WKWebView with Maraca.shared.webViewConfiguration after
// setting up Maraca
private var webview: WKWebView!
private func setupUI() {
webview = {
let w = WKWebView(frame: .zero, configuration: Maraca.shared.webViewConfiguration)
w.navigationDelegate = self
return w
}()
view.addSubview(webview)
// Set up constraints, etc..
let myWebApplicationURLString = .....
guard let url = URL(string: myWebApplicationURLString) else {
return
}
loadMyWebApplication(with: url)
}
```
## Documentation
Full documentation can be found [here](https://docs.socketmobile.com/rumba/en/latest/maraca.html)
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Installation
Maraca is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'MaracaPod'
```
## License
Maraca is available under the MIT license. See the LICENSE file for more info.