From bb075db9e0aff1a6c0dc8faa735c57f879c14274 Mon Sep 17 00:00:00 2001 From: ssangamesh Date: Tue, 15 Jul 2025 11:05:46 +0000 Subject: [PATCH 1/9] grpc-io : update prerequisites with AndroidX with java version guidance in quickstart.md --- content/en/docs/platforms/android/java/quickstart.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/content/en/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md index f132c0753fd..77d4345d71c 100644 --- a/content/en/docs/platforms/android/java/quickstart.md +++ b/content/en/docs/platforms/android/java/quickstart.md @@ -24,10 +24,15 @@ weight: 10 - An android device set up for [USB debugging][] or an [Android Virtual Device][] +- Add the following line in your gradle.properties to ensure compatibility with Android tooling and libraries: + **android.useAndroidX=true** + {{% alert title="Note" color="info" %}} gRPC Java does not support running a server on an Android device. For this quick start, the Android client app will connect to a server running on your local (non-Android) computer. + + Since the AGP version used is 7.x, you need to use Java versions 17 - 21 to avoid DexWorkAction / D8 errors. {{% /alert %}} ### Get the example code From cdde9afaf66d15e29deab3435c4528967bbb27e4 Mon Sep 17 00:00:00 2001 From: ssangamesh Date: Fri, 18 Jul 2025 05:13:34 +0000 Subject: [PATCH 2/9] grpc-io : update prerequisites with AndroidX with java and agp version guidance in quickstart.md --- content/en/docs/platforms/android/java/quickstart.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/content/en/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md index 77d4345d71c..5acc526fb90 100644 --- a/content/en/docs/platforms/android/java/quickstart.md +++ b/content/en/docs/platforms/android/java/quickstart.md @@ -32,8 +32,9 @@ weight: 10 quick start, the Android client app will connect to a server running on your local (non-Android) computer. - Since the AGP version used is 7.x, you need to use Java versions 17 - 21 to avoid DexWorkAction / D8 errors. -{{% /alert %}} +For AGP 7.x, it's recommended to use Java 11, 17, or 20 to avoid DexWorkAction / D8 issues. +While Java 21 might technically work, it's safer to avoid it due to potential compatibility quirks. +Note that AGP 8.x and later explicitly require Java 17 as the minimum version.{{% /alert %}} ### Get the example code From 00cc8140872ffb6f6101147ca518657ae94efa84 Mon Sep 17 00:00:00 2001 From: ssangamesh Date: Fri, 18 Jul 2025 09:24:46 +0000 Subject: [PATCH 3/9] grpc-io : fixed based on review points --- content/en/docs/platforms/android/java/quickstart.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md index 5acc526fb90..807d7691f3b 100644 --- a/content/en/docs/platforms/android/java/quickstart.md +++ b/content/en/docs/platforms/android/java/quickstart.md @@ -32,8 +32,8 @@ weight: 10 quick start, the Android client app will connect to a server running on your local (non-Android) computer. -For AGP 7.x, it's recommended to use Java 11, 17, or 20 to avoid DexWorkAction / D8 issues. -While Java 21 might technically work, it's safer to avoid it due to potential compatibility quirks. +For AGP 7.x, it's recommended to use Java 11 - 20 to avoid DexWorkAction / D8 issues. +Java 21+ (which produces bytecode version 65+) is not supported by AGP 7.x and will cause build failures due to bytecode incompatibility. AGP 7.x supports up to bytecode version 61. Note that AGP 8.x and later explicitly require Java 17 as the minimum version.{{% /alert %}} ### Get the example code From b43b5e730a5f22fed59fa9c7fc183820b980301d Mon Sep 17 00:00:00 2001 From: ssangamesh Date: Fri, 18 Jul 2025 09:38:13 +0000 Subject: [PATCH 4/9] grpc-io : fixed based on review points --- content/en/docs/platforms/android/java/quickstart.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md index 807d7691f3b..90d600e28e2 100644 --- a/content/en/docs/platforms/android/java/quickstart.md +++ b/content/en/docs/platforms/android/java/quickstart.md @@ -33,7 +33,7 @@ weight: 10 local (non-Android) computer. For AGP 7.x, it's recommended to use Java 11 - 20 to avoid DexWorkAction / D8 issues. -Java 21+ (which produces bytecode version 65+) is not supported by AGP 7.x and will cause build failures due to bytecode incompatibility. AGP 7.x supports up to bytecode version 61. +Java 21+ (which produces bytecode version 65+) is not supported by AGP 7.x and will result in build failures due to bytecode incompatibility. AGP 7.x supports up to bytecode version 61. Note that AGP 8.x and later explicitly require Java 17 as the minimum version.{{% /alert %}} ### Get the example code From 311dc52d6c39a4adda392cbcb13dc6dd22f81bbd Mon Sep 17 00:00:00 2001 From: ssangamesh Date: Mon, 21 Jul 2025 02:57:20 +0000 Subject: [PATCH 5/9] grpc-io : fixed based on review points --- content/en/docs/platforms/android/java/quickstart.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/content/en/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md index 90d600e28e2..f4ba8f88ee7 100644 --- a/content/en/docs/platforms/android/java/quickstart.md +++ b/content/en/docs/platforms/android/java/quickstart.md @@ -6,7 +6,10 @@ weight: 10 ### Prerequisites -- [JDK][] version 7 or higher +- [JDK][] version 11–17 is required. + + 1. The example uses AGP 7.x (compatible with Java 11–17). If you upgrade it to AGP 8.x requires Java 17+. + - Android SDK, API level 16 or higher 1. Install [Android Studio][] or the Android [command-line tools][]. @@ -27,6 +30,8 @@ weight: 10 - Add the following line in your gradle.properties to ensure compatibility with Android tooling and libraries: **android.useAndroidX=true** +- The examples default to AGP 7.x which needs Java 11 to 17. If you upgrade it to AGP 8.x, it needs Java 17+ + {{% alert title="Note" color="info" %}} gRPC Java does not support running a server on an Android device. For this quick start, the Android client app will connect to a server running on your From 00b1168cc7a8a6360997dc30e6f7926eb39e5a5a Mon Sep 17 00:00:00 2001 From: ssangamesh Date: Mon, 21 Jul 2025 03:03:07 +0000 Subject: [PATCH 6/9] grpc-io : fixed based on review points --- content/en/docs/platforms/android/java/quickstart.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/en/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md index f4ba8f88ee7..5e6d682e6ae 100644 --- a/content/en/docs/platforms/android/java/quickstart.md +++ b/content/en/docs/platforms/android/java/quickstart.md @@ -30,8 +30,6 @@ weight: 10 - Add the following line in your gradle.properties to ensure compatibility with Android tooling and libraries: **android.useAndroidX=true** -- The examples default to AGP 7.x which needs Java 11 to 17. If you upgrade it to AGP 8.x, it needs Java 17+ - {{% alert title="Note" color="info" %}} gRPC Java does not support running a server on an Android device. For this quick start, the Android client app will connect to a server running on your From 3d060914b84194379cddf18d2bb2824d98cbcc4d Mon Sep 17 00:00:00 2001 From: ssangamesh Date: Mon, 21 Jul 2025 03:05:45 +0000 Subject: [PATCH 7/9] grpc-io : fixed based on review points --- content/en/docs/platforms/android/java/quickstart.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/content/en/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md index 5e6d682e6ae..d0768faf877 100644 --- a/content/en/docs/platforms/android/java/quickstart.md +++ b/content/en/docs/platforms/android/java/quickstart.md @@ -34,10 +34,7 @@ weight: 10 gRPC Java does not support running a server on an Android device. For this quick start, the Android client app will connect to a server running on your local (non-Android) computer. - -For AGP 7.x, it's recommended to use Java 11 - 20 to avoid DexWorkAction / D8 issues. -Java 21+ (which produces bytecode version 65+) is not supported by AGP 7.x and will result in build failures due to bytecode incompatibility. AGP 7.x supports up to bytecode version 61. -Note that AGP 8.x and later explicitly require Java 17 as the minimum version.{{% /alert %}} +{{% /alert %}} ### Get the example code From 27f867715d263bb12bbdc57816f29eb084162ff2 Mon Sep 17 00:00:00 2001 From: ssangamesh Date: Mon, 21 Jul 2025 03:11:08 +0000 Subject: [PATCH 8/9] grpc-io : fixed based on review points --- content/en/docs/platforms/android/java/quickstart.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md index d0768faf877..b0473aa3040 100644 --- a/content/en/docs/platforms/android/java/quickstart.md +++ b/content/en/docs/platforms/android/java/quickstart.md @@ -6,7 +6,7 @@ weight: 10 ### Prerequisites -- [JDK][] version 11–17 is required. +- [JDK][] version 11 or higher. 1. The example uses AGP 7.x (compatible with Java 11–17). If you upgrade it to AGP 8.x requires Java 17+. From a857b7f61919730919bc760c00e2c0084dcd7b44 Mon Sep 17 00:00:00 2001 From: MV Shiva Date: Mon, 21 Jul 2025 14:13:47 +0530 Subject: [PATCH 9/9] Update quickstart.md --- content/en/docs/platforms/android/java/quickstart.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/platforms/android/java/quickstart.md b/content/en/docs/platforms/android/java/quickstart.md index b0473aa3040..43d9af90dac 100644 --- a/content/en/docs/platforms/android/java/quickstart.md +++ b/content/en/docs/platforms/android/java/quickstart.md @@ -8,7 +8,7 @@ weight: 10 - [JDK][] version 11 or higher. - 1. The example uses AGP 7.x (compatible with Java 11–17). If you upgrade it to AGP 8.x requires Java 17+. + 1. The example uses AGP 7.x (compatible with Java 11–17). If you upgrade it to AGP 8.x, it requires Java 17+. - Android SDK, API level 16 or higher