Discourage use of GSON
PiperOrigin-RevId: 688704701
Change-Id: I49ceabcdf37c186df4731a9df6b351dd7d150d15
diff --git a/docs/api_guidelines/dependencies.md b/docs/api_guidelines/dependencies.md
index 74b88cd..c6f1576 100644
--- a/docs/api_guidelines/dependencies.md
+++ b/docs/api_guidelines/dependencies.md
@@ -236,15 +236,19 @@
}
```
-### System health {#dependencies-health}
+### Dependency considerations {#dependencies-health}
Generally, Jetpack libraries should avoid dependencies that negatively impact
developers without providing substantial benefit. Libraries should consider the
-system health implications of their dependencies, including:
+implications of their dependencies, including:
- Large dependencies where only a small portion is needed (e.g. APK bloat)
- Dependencies that slow down build times through annotation processing or
compiler overhead
+- Dependencies which do not maintain binary compatibility and conflict with
+ semantic versioning guarantees
+- Dependencies that are intended for server environments and don't interact
+ well with the Android build toolchain (e.g. R8) or runtime (e.g. ART)
#### Kotlin {#dependencies-kotlin}
@@ -281,6 +285,12 @@
}
```
+#### GSON {#dependencies-gson}
+
+GSON relies heavily on reflection and interacts poorly with app optimization
+tools like R8. Instead, consider using `org.json` which is included in the
+Android platform SDK.
+
#### Guava {#dependencies-guava}
The full Guava library is very large and should only be used in cases where
