SDK Installation
Ionic

Get Started

7min
this plugin gives your team the power to easily integrate it into your ionic application follow these simple steps installation install the plugin using the popular single commands in the terminal/powershell cordova $ ionic cordova plugin add @letscooee/cordova plugin variable cooee app id="my cooee app id" $ npm install @awesome cordova plugins/lets cooee this will automatically pull the latest version of the plugin replace my cooee app id with the app id which is present at cooee portal notification service configuration (only for ios) this plugin adds cooeenotificationserviceextension as a new target in the ios platform just add build number and build version in the new target see the below image for reference permission usage cooee uses a few permissions, if granted (we do not ask explicitly), to better understand your customer to engage them as per their needs android (optional) cooee sdk supports prompting the following permissions via engagement to make it work, you need to add the following in app's config xml under \<platforms name="android"> file \<! cooee sdk use this permission to run augmented reality engagements > \<config file target="androidmanifest xml" parent="/manifest"> \<uses permission android\ name="android permission camera" /> \</config file> \<! cooee sdk use this permission to run location based engagements > \<config file target="androidmanifest xml" parent="/manifest"> \<uses permission android\ name="android permission access fine location" /> \</config file> ios (required) apple requires a user friendly description of such permissions as defined here add below code in your config xml under \<platforms name="ios"> \<edit config file=" info plist" mode="merge" target="nslocationwheninuseusagedescription"> \<string>app uses location to search retailer location\</string> \</edit config> \<edit config file=" info plist" mode="merge" target="nsbluetoothalwaysusagedescription"> \<string>app uses bluetooth to find out nearby devices\</string> \</edit config> \<edit config file=" info plist" mode="merge" target="nscamerausagedescription"> \<string>need to access your camera for a better ar experience\</string> \</edit config> android configuration the minimum supported android version for cooee is api 21 this requires a small configuration mentioned below in your config xml under \<platforms name="android"> \<! add xmlns\ android & xmlns\ tools to widget tag > \<widget xmlns\ android="http //schemas android com/apk/res/android" xmlns\ tools="http //schemas android com/tools"> \<platform name="android"> \<! sets minimum android sdk to 21 > \<preference name="android minsdkversion" value="21"/> \<! enable google play service for android > \<preference name="gradleplugingoogleservicesenabled" value="true" /> \<! sets configuration for com google ar core > \<config file target="androidmanifest xml" parent="/manifest/application"> \<meta data android\ name="com google ar core" android\ value="optional" /> \</config file> \<! adds xmlns\ tools in androidmanifest xml's manifest tag > \<edit config file="app/src/main/androidmanifest xml" target="/manifest" mode="merge"> \<manifest xmlns\ tools="http //schemas android com/tools"/> \</edit config> \<! adds android\ name in androidmanifest xml's application tag > \<edit config file="app/src/main/androidmanifest xml" target="/manifest/application" mode="merge"> \<application android\ name="com letscooee cordova cooeeplugincontroller" tools\ replace="android\ name"/> \</edit config> \</platform> \<widget/> grab reference import {cooee} from '@awesome cordova plugins/lets cooee';