Modify deploy_docs script to include Android

.github/workflows/android-release.yml

@@ -0,0 +1,32 @@
+name: Android Client Publish
+
+on:
+ release:
+ # We'll run this workflow when a new GitHub release is created
+ types: [released]
+
+jobs:
+ publish:
+ defaults:
+ run:
+ working-directory: src/kotlin
+ name: Release build and publish
+ runs-on: ubuntu-latest
+ steps:
+ - name: Check out code
+ uses: actions/checkout@v3
+ - name: Set up JDK 11
+ uses: actions/setup-java@v3
+ with:
+ distribution: adopt
+ java-version: 11
+
+ # Runs upload, and then closes & releases the repository
+ - name: Publish to MavenCentral
+ run: ./gradlew publishAllPublicationsToMavenCentral --no-configuration-cache
+ env:
+ ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.GRADLE_OSSRH_USERNAME }}
+ ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.GRADLE_OSSRH_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.GRADLE_SIGNING_KEY_ID }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.GRADLE_SIGNING_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.GRADLE_SIGNING_KEY }}

dev/deploy-docs.sh

@@ -40,3 +40,10 @@ cd examples/doc
 make docs
 cd build/html
 aws s3 sync --delete --exclude ".*" --exclude "v/*" --acl public-read --cache-control "no-cache" ./ s3://flower.dev/docs/examples
+
+# Build and deploy Flower Android docs
+cd $ROOT
+cd src/kotlin
+./gradlew dokkaHtml
+cd build/dokka/html
+aws s3 sync --delete --exclude ".*" --exclude "v/*" --acl public-read --cache-control "no-cache" ./ s3://flower.dev/docs/android

src/kotlin/.gitignore

@@ -0,0 +1,15 @@
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties

src/kotlin/build.gradle.kts

@@ -0,0 +1,18 @@
+buildscript {
+ repositories {
+ google()
+ mavenCentral()
+ }
+ dependencies {
+ // Not 8.0.2 because on macOS `Could not find protoc-3.11.0-osx-aarch_64.exe (com.google.protobuf:protoc:3.11.0)`
+ classpath("com.android.tools.build:gradle:7.4.2")
+ // Not 0.9.2 because of https:/grpc/grpc-kotlin/issues/380
+ classpath("com.google.protobuf:protobuf-gradle-plugin:0.9.1")
+ classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0")
+
+ classpath("com.vanniktech:gradle-maven-publish-plugin:0.25.3") // NEW
+
+ // NOTE: Do not place your application dependencies here; they belong
+ // in the individual module build.gradle files
+ }
+}

src/kotlin/flwr/.gitignore

@@ -0,0 +1 @@
+/build

src/kotlin/flwr/build.gradle.kts

@@ -0,0 +1,107 @@
+import org.jetbrains.dokka.gradle.DokkaTask
+import org.jetbrains.dokka.base.DokkaBase
+import org.jetbrains.dokka.base.DokkaBaseConfiguration
+
+plugins {
+ id("com.android.library")
+ id("org.jetbrains.kotlin.android")
+ id("com.google.protobuf")
+ id("maven-publish")
+ id("com.vanniktech.maven.publish")
+ id("org.jetbrains.dokka") version "1.8.20"
+}
+
+buildscript {
+ dependencies {
+ classpath("org.jetbrains.dokka:dokka-base:1.8.20")
+ }
+}
+
+android {
+ namespace = "dev.flower"
+ compileSdk = 33
+
+ defaultConfig {
+ aarMetadata {
+ minCompileSdk = 28
+ }
+ minSdk = 28
+ testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+ }
+
+ buildTypes {
+ getByName("release") {
+ isMinifyEnabled = false
+ proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
+ }
+ }
+ compileOptions {
+ sourceCompatibility = JavaVersion.VERSION_1_8
+ targetCompatibility = JavaVersion.VERSION_1_8
+ }
+ kotlinOptions {
+ jvmTarget = "1.8"
+ }
+ buildFeatures {
+ compose = true
+ }
+ composeOptions {
+ kotlinCompilerExtensionVersion = "1.5.1"
+ }
+ packagingOptions {
+ resources {
+ excludes.add("/META-INF/{AL2.0,LGPL2.1}")
+ }
+ }
+}
+
+val grpcVersion = "1.56.1"
+
+protobuf {
+ protoc {
+ artifact = "com.google.protobuf:protoc:3.23.4"
+ }
+ plugins {
+ create("grpc") {
+ artifact = "io.grpc:protoc-gen-grpc-java:$grpcVersion"
+ }
+ }
+ generateProtoTasks {
+ all().forEach { task ->
+ task.builtins {
+ create("java") {
+ option("lite")
+ }
+ }
+ task.plugins {
+ create("grpc") {
+ option("lite")
+ }
+ }
+ }
+ }
+}
+
+tasks.dokkaHtml {
+ pluginConfiguration<DokkaBase, DokkaBaseConfiguration> {
+ customStyleSheets = listOf(file("res/style.css"))
+ customAssets = listOf(file("res/logo-icon.svg"))
+ footerMessage = "(c) 2023 Flower Labs GmbH"
+ }
+}
+
+dependencies {
+ implementation("androidx.core:core-ktx:1.10.1")
+ implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
+ implementation("io.grpc:grpc-okhttp:$grpcVersion")
+ implementation("io.grpc:grpc-protobuf-lite:$grpcVersion")
+ implementation("io.grpc:grpc-stub:$grpcVersion")
+ implementation("javax.annotation:javax.annotation-api:1.3.2")
+
+ protobuf(files("../../proto"))
+ dokkaPlugin("org.jetbrains.dokka:android-documentation-plugin:1.8.20")
+
+ testImplementation("junit:junit:4.13.2")
+ androidTestImplementation("androidx.test.ext:junit:1.1.5")
+ androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
+}

src/kotlin/flwr/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.kts.
+#
+# For more details, see
+# http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+# public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile