INSTALLATION.md

Installation

Gradle

Add the dependency from Maven Central to your app module's (not top-level) build.gradle.kts file:

dependencies {
    implementation("dev.hotwire:strada:<latest-version>")
}

See the latest version available on Maven Central.

Note: strada-android works seamlessly with turbo-android and the documentation provides instructions for integrating Strada with your Turbo Native app. Keep in mind that turbo-android is not automatically included as a dependency in strada-android, so you'll want to setup your turbo-android app first.

Required minSdkVersion

Android SDK 26 (or greater) is required as the minSdkVersion in your app module's build.gradle file:

compileSdk = 34

defaultConfig {
    minSdk = 26
    targetSdk = 34
    // ...
}

Pre-release Builds

Pre-release builds will be published to GitHub Packages.

Personal Access Token

If you'd like to use a pre-release version, you'll need to create a Personal Access Token in your GitHub account and give it the read:packages permission.

Copy your access token to your .bash_profile (or another accessible place that's outside of source control):

export GITHUB_USER='<your username>'
export GITHUB_ACCESS_TOKEN='<your personal access token>'

Gradle

Add the GitHub Packages maven repository and the dependency to your app module's build.gradle file:

repositories {
    maven {
        name = "GitHubPackages"
        url = uri("https://maven.pkg.github.com/hotwired/strada-android")

        credentials {
            username = System.getenv('GITHUB_USER')
            password = System.getenv('GITHUB_ACCESS_TOKEN')
        }
    }
}

dependencies {
    implementation("dev.hotwire:strada:<pre-release-version>")
}