!Ace Logo Visit our homepage & get started in minutes!
WHAT IS ACE?
An Apache Cordova plugin that enables you to easily add native UI and native code to your JavaScript and HTML.
* Mix native UI with HTML
* Use a cross-platform native UI framework
* Call native code without additional plugins
!
Ace Diagram
QUICK START
$3
From a Command Prompt (Windows) or Terminal (Mac):
* Install NPM, which is
included in the Node.js installation, if you haven't already
* Install Cordova using NPM (this might require executing with sudo on a Mac):
``
npm install -g cordova
`
* Go to the examples/AceExamples subfolder, then run:
`
cordova prepare
cordova run android
cordova run ios
`
Or, Using Visual Studio:
* Ensure you have Tools for Apache Cordova installed
* Open examples/AceExamples/AceExamples.sln
* Deploy to either an Android emulator or device (KitKat or later, ideally Marshmallow), or an iOS remote device
* If you need a Marshmallow Android emulator, run the "Visual Studio Emulator for Android" program from the Start menu to download one.
$3
Just add the plugin to your Cordova project. Whether you use Visual Studio or command-line tools, Windows or Mac, you can add this plugin the standard way. For example:
`
cordova plugin add cordova-plugin-ace
``
or, in Visual Studio, open
config.xml then add the plugin under
Plugins,
Custom. You can point it at https://github.com/microsoft/ace.git or a local copy that you download.
Then follow the examples and docs. You can find examples in the examples folder of this repository.
COMMUNITY
* Have a question that's not a feature request or bug report?
Discuss on Stack Overflow
* Have a feature request or find a bug?
Submit an issue
* Please
contribute to the source code!
DEVELOPMENT
The easiest way to test plugin code changes is to copy the examples/AceExamples folder
outside of the plugin folder,
remove the Ace plugin from the project, and then add it back using a path to your local ace folder with your code changes.
Just remember to copy any enhancements you make to the AceExamples project back to the original location!
LICENSE
Ace is licensed under the MIT Open Source license.