ANDROID QUICK START
IBEACONS TECHNOLOGY
1
Create
your developper account
Go to the Beaconwatcher Manager and create an account.
Sign up
2
Create
your Android Application
The following steps will set up an application in Eclipse ready for enabling Beaconwatcher features.
3
Confirm
your environment
- Have a device with Android 4.3 or higher
- Are using Eclipse Indigo (3.7) or higher
- Have installed the Eclipse Android ADT plug-in
- Use the ADT plug-in to download a version of Android greater than or equal to API 18: Android 4.3
4
Create
a new Eclipse project
In Eclipse choose File > New > Project and search for “Android Application Project” as seen below.
Fill out your “Application Name”, “Project Name”, and “Package Name” fields.
Important: Make sure the “Minimum Required SDK”, “Target SDK” are set to at least API 18 and “Compile With” fields are set to API 18: Android 4.3. Then click through the rest of the “New Android Application” setup wizard.
5
Add SDK Jar
to your project
Click to download: BeaconW-SDK.1.0.jar
Note: You will find the jar at above link
Add jar to your Android application by copy and pasting it into the libs folder of your android project.
Your project should now look similar to this:
- Add the follwoing sdk and permission declarations to your AndroidManifest.xml
<uses-sdk android:minSdkVersion="18" android:targetSdkVersion="18" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.BLUETOOTH" /> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
- Edit your project.properties file and add the line:Â manifestmerger.enabled=true
- Only perform this step if you are using a version prior to 0.7.1 or if you do not have manifest merging enabled per step 2. If manifest merging does not work, you must manually add the following service declarations to your AnroidManifest.xml, replacing {my app’s package name} with the fully qualified package name of your Android application.
<service android:enabled="true" android:exported="true" android:isolatedProcess="false" android:label="iBeacon" android:name="com.radiusnetworks.ibeacon.service.IBeaconService"> </service> <service android:enabled="true" android:exported="true" android:isolatedProcess="false" android:name="com.radiusnetworks.ibeacon.IBeaconIntentProcessor"> <meta-data android:name="background" android:value="true" /> <intent-filter android:priority="1" > <action android:name="com.radiusnetwork.demo.DID_RANGING" /> <action android:name="com.radiusnetwork.demo.DID_MONITORING" /> </intent-filter> </service>