Skip to content

grpc-io: Update Android quickstart docs with AndroidX and java version guidance in quickstart.md #1452

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Jul 21, 2025
Merged

grpc-io: Update Android quickstart docs with AndroidX and java version guidance in quickstart.md #1452

Changes from 4 commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
bb075db
grpc-io : update prerequisites with AndroidX with java version guidan…
Sangamesh1997 Jul 15, 2025
e7f16b5
Merge branch 'grpc:main' into Issue_11836_fixed
Sangamesh1997 Jul 17, 2025
578c1b4
Merge branch 'grpc:main' into Issue_11836_fixed
Sangamesh1997 Jul 18, 2025
cdde9af
grpc-io : update prerequisites with AndroidX with java and agp versio…
Sangamesh1997 Jul 18, 2025
00cc814
grpc-io : fixed based on review points
Sangamesh1997 Jul 18, 2025
b43b5e7
grpc-io : fixed based on review points
Sangamesh1997 Jul 18, 2025
311dc52
grpc-io : fixed based on review points
Sangamesh1997 Jul 21, 2025
00b1168
grpc-io : fixed based on review points
Sangamesh1997 Jul 21, 2025
3d06091
grpc-io : fixed based on review points
Sangamesh1997 Jul 21, 2025
27f8677
grpc-io : fixed based on review points
Sangamesh1997 Jul 21, 2025
a857b7f
Update quickstart.md
shivaspeaks Jul 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion content/en/docs/platforms/android/java/quickstart.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,11 +24,17 @@ 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.
{{% /alert %}}

For AGP 7.x, it's recommended to use Java 11, 17, or 20 to avoid DexWorkAction / D8 issues.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just mention 11 - 20

While Java 21 might technically work, it's safer to avoid it due to potential compatibility quirks.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since we know "AGP 7.x’s D8 supports bytecode up to v61, so Java 21+ (v65+) fails." why not explicitly mention that 21+ will not work?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed and updated the message.Thanks!

Note that AGP 8.x and later explicitly require Java 17 as the minimum version.{{% /alert %}}

### Get the example code

Expand Down