AndroidBibleUtils

General tools for integrating and navigating the Bible on Android, leveraging YouVersion's APIs:

• Passage selector BibleNavSmall auto-sizing custom View
• Passage text fetcher YVFetcher or fetch from local files (not included) via LocalBibleFetcher
• Audio fetcher and player PassagePlayer
• Get Lens-like verse text art via VerseBitmapFetcher (thanks, Scott!)
• Link out to YV's Bible app and recieve share intents as references via YVAppTools
• Get the YV Verse of the Day via YVVotdFetcher
• Search with YVFetcher.search()

Demo app showing BibleNavSmall UI, YVFetcher grabbing verses, and VerseBitmapFetcher for image:

Implementation

Include as a Jitpack library

Use the latest tagged version shown here: https://jitpack.io/#briandherbert/AndroidBibleUtils

In your projects's build.gradle file, add the jitpack repo:

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io' }
    }
}

Then in the app module's build.gradle, add the dependency (use latest version):

implementation 'com.github.briandherbert:AndroidBibleUtils:v3.0.3'

Specific Usage

See the demo app for examples.

For fetching verses, include internet permissions in AndroidManifest:
<uses-permission android:name="android.permission.INTERNET" />

BibleFetchers can fetch verses using the BibleRef class or plaintext, including ranges: mBibleFetcher.getPassage("Genesis 1:1 - 3")

PassagePlayer (audio) requires the obscure AndroidManifest line android:usesCleartextTraffic="true" under the <application tag

YVAppTools Launch out to Bible app via YVAppTools.goToApp(activity: Activity, ref: BibleRef) or Bible.com if not installed (check via YVAppTools.isYVInstalled())
To capture share intents, add this to the manifest under your activity:

<intent-filter>
    <action android:name="android.intent.action.SEND" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:mimeType="text/plain" />
</intent-filter>

then in your activity:

when {
        intent?.action == Intent.ACTION_SEND -> {
            if ("text/plain" == intent.type) {
                YVAppTools.parseYVShareIntent(intent)
            }
        }
    }