Repository files navigation

An Android library providing APIs to interact with beacons. Please visit theproject 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 theBeaconParser class.

It allows Android devices to use beacons much like iOS devices do. An app can request to get notifications when oneor more beacons appear or disappear. An app can also request to get a ranging update from one or more beaconsat a frequency of approximately 1Hz.

Theproject website hasfull documentation

You maydownload binary releases here.

Add Maven Central to your build file's list of repositories.

repositories {   mavenCentral()}

to use the Maven Central Repository

dependencies {...    implementation'org.altbeacon:android-beacon-library:${altbeacon.version}'...}

replacing${altbeacon.version} with the version you wish to use.

This project uses an AndroidStudio/gradle build system and is known working with Android Studio Flamingo | 2022.2.1 Patch 1 and Gradle 8.0

Key Gradle build targets:

./gradlew test # run unit tests. To see results: `open lib/build/reports/tests/testDebugUnitTest/index.html`./gradlew build # development build./gradlew release # release build

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.0Unless required by applicable law or agreed to in writing, softwaredistributed 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 andlimitations 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, contactdavid@radiusnetworks.com

The following instructions are for project administrators.

1. Prerequisites:https://getstream.io/blog/publishing-libraries-to-mavencentral-2021/

2. Configure your ~/.gradle/gradle.properties with:

    signing.keyId=<my key id> signing.password=<my passphrase> signing.secretKeyRingFile=<path to exported gpg file> signing.password=<my passphrase> ossrhUsername=<sonotype server username> ossrhPassword=<sonotype server password>

3. Run the build and upload

    git tag <version> git push --tags  ./gradlew release ./gradlew mavenPublish # Wait 10 mins before using the next command ./gradlew closeAndReleaseRepository

4. Keep checking for a half hour or so athttps://repo1.maven.org/maven2/org/altbeacon/android-beacon-library/ to see that the new release shows up.

Note: you must have Java 17 to build the projecdt. If that is not the version on the path, and you have Android Studio installed, you may be able to add it to the path with:

export PATH=/Applications/Android\ Studio.app/Contents/jbr/Contents/Home/bin:$PATH