Modify deploy_docs script to include Android

.github/workflows/android-release.yml

@@ -0,0 +1,24 @@
+name: Android Client Publish
+
+on:
+ pull_request
+
+jobs:
+ deploy_docs:
+ runs-on: ubuntu-latest
+ name: Deploy Android docs 
+ 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
+ - name: Build and deploy docs
+ env:
+ AWS_DEFAULT_REGION: ${{ secrets. AWS_DEFAULT_REGION }}
+ AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
+ AWS_SECRET_ACCESS_KEY: ${{ secrets. AWS_SECRET_ACCESS_KEY }}
+ run: ./dev/deploy-android-docs.sh
+

.gitignore

@@ -164,3 +164,21 @@ poetry.lock
 
 # iOS
 xcuserdata/
+
+# Android
+.gradle
+.idea
+local.properties
+app/src/main/assets
+/build
+*.iml
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+/captures
+.externalNativeBuild
+.cxx

dev/deploy-android-docs.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+
+# Copyright 2020 Adap GmbH. All Rights Reserved.
+#
+# 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.
+# ==============================================================================
+
+set -e
+cd "$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"/../
+
+ROOT=`pwd`
+
+# Build and deploy Flower Android docs
+cd $ROOT
+cd src/kotlin
+./gradlew dokkaHtml
+cd flwr/build/dokka/html
+aws s3 sync --delete --exclude ".*" --exclude "v/*" --acl public-read --cache-control "no-cache" ./ s3://flower.dev/docs/android

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/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