Android Beacon Library
An Android library providing APIs to interact with beacons. Please visit the project website for how to use this library.
IMPORTANT: By default, this library will only detect beacons meeting the AltBeacon specification.
If you want this library to work with proprietary or custom beacons, see the BeaconParser class.
What does this library do?
It allows Android devices to use beacons much like iOS devices do. An app can request to get notifications when one or more beacons appear or disappear. An app can also request to get a ranging update from one or more beacons at a frequency of approximately 1Hz.
Documentation
The project website has full documentation including Javadocs.
Changes from the 0.x library version
This library has changed significantly from the 0.x library version and is now designed to work with open AltBeacons which fully support Android without any intellectual property restrictions. For more information on how to migrate projects using the 0.x APIs to the 2.x APIs, see API migration.
Downloads
Binary
You may download binary releases here.
JCenter
Add JCenter to your build file's list of repositories.
repositories {
jcenter()
}
to use the JCenter Repository
dependencies {
...
implementation 'org.altbeacon:android-beacon-library:${altbeacon.version}'
...
}
replacing ${altbeacon.version}
with the version you wish to use.
How to build this Library
This project uses an AndroidStudio/gradle build system and is known working with Android Studio 3.4.1 and Gradle 5.1.1
Key Gradle build targets:
./gradlew test # run unit tests
./gradlew build # development build
./gradlew release -Prelease # release build
License
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
This software is available under the Apache License 2.0, allowing you to use the library in your applications.
If you want to help with the open source project, contact [email protected]
Publishing to Maven
The following instructions are for project administrators.
-
Upload you Sonotype signing keypair to Bintray
-
Configure your ~/.gradle/gradle.properties with:
signing.keyId=<my key id> signing.password=<my passphrase> signing.secretKeyRingFile=~/.gnupg/secring.gpg signingPassword=<my passphrase> bintrayUserName=<bintray username> bintrayKey=<bintray api key>
-
Run the build and upload
git tag <version> git push --tags ./gradlew release -Prelease ./gradlew bintrayUpload -Prelease
-
Log in to JCenter, hit the button to publish the release, then select the Maven tab and enter your credentials to Sync to Maven