Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
doc
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Utility Extension from Smartface

Twitter: @Smartface_io License

An extension that has following utility classes for Smartface Native Framework.

  • RAU (easy use for Remote App Update)
  • Fingerprint & Touch ID (easy & best practice use for Fingerprint)
  • Alert (fixes global alert)
  • SpeechToText (setups timers for speech recognition)
  • Permission (gets permissions with ease using a simple callback)
  • Location (gets location with callback, no need to worry for the permission code)
  • Timers (fixes thread issue of setTimeout & setInterval)
  • Orientation (solves problems of managing different behaviour of Oritentation of iOS & Android)
  • ServiceCall (service call library for common JSON requests)
  • ServiceCallOffline (service call library with offline capability)
  • ButtonActivity (setting an activity indicator with correct elevation on top of a button)
  • WebViewBridge (bi directional communication)
  • Touch (addPress event to any target object)
  • Color (converts Smartface color to TinyColor for color manipulations)
  • TextBox (max text length)
  • Copy (creates a shallow copy of an object)
  • Router (with buildExtender, page management made easy)
  • Guid (creates uuid-v4 text)
  • getCombinedStyle (gets style object from theme class)
  • RTLTabBarController (supports Right-To-Left direction and vice versa)
  • RTLSwipeView (supports Right-To-Left direction and vice versa)
  • PDF (renders base64 string as pdf file in a WebView)
  • RootDetection (detects if the device is rooted or not)
  • Art (Smartface module that allows you to draw vector graphics)

Installation

Utility extension can be installed via npm easily from our public npm repository. The installation is pretty easy via Smartface Cloud IDE. Run the following code in terminal

(cd ~/workspace/scripts && npm i -S sf-extension-utils)

How to use

1. Fix global methods

In app.js make sure that require("sf-extension-utils") is set. This is fixing alert, setTimeout, setInterval, clearTimeout and clearInterval methods. Some of the other util modules might depend on it!

2. Require util modules

Later in any file, require it with the path: require("sf-extension-utils/lib/<moduleName>") Such as:

  • require("sf-extension-utils/lib/rau")
  • require("sf-extension-utils/lib/permission")
  • require("sf-extension-utils/lib/fingerprint")
  • require("sf-extension-utils/lib/speechtotext")
  • require("sf-extension-utils/lib/location")

API

For each module api documentation is in separate file. Please visit doc folder

Release

Before publishing the utils

  • Make sure the docs are up-to-date
npm run docs
  • Make sure the changelogs are generated
npm run changelog

Need Help?

Please submit an issue on GitHub and provide information about your problem.

Support & Documentation & Useful Links

Code of Conduct

We are committed to making participation in this project a harassment-free experience for everyone, regardless of the level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality. Please read and follow our Code of Conduct.

License

This project is licensed under the terms of the MIT license. See the LICENSE file. Within the scope of this license, all modifications to the source code, regardless of the fact that it is used commercially or not, shall be committed as a contribution back to this repository.

About

Smartface Native Framework extension that has useful utility classes to use in your applications

Resources

License

Packages

No packages published
You can’t perform that action at this time.