Skip to content

Commit 7eaa494

Browse files
authored
Update platform_specific_instructions.md
1 parent 922ecd9 commit 7eaa494

File tree

1 file changed

+19
-11
lines changed

1 file changed

+19
-11
lines changed

doc/dev_guide/platform_specific_instructions.md

Lines changed: 19 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -27,19 +27,22 @@ In case you are having a local build failure on macOS due to "audio_session" do
2727

2828
## Android (Work in Progress)
2929

30-
- If any case targeting the Android API level below 21 or the project and the libraries it references exceed 65,536 methods, you encounter the following build error that indicates your app has reached the limit of the Android build architecture:
30+
In case you are targeting the Android API level <21 or the project and the libraries it references exceed 65,536 methods, you encounter the following build error that indicates your app has reached the limit of the Android build architecture:
31+
3132
```
3233
trouble writing output:
3334
Too many field references: 131000; max is 65536.
3435
You may try using --multi-dex option.
3536
```
37+
3638
OR
39+
3740
```
3841
Conversion to Dalvik format failed:
3942
Unable to execute dex: method ID not in [0, 0xffff]: 65536
4043
```
41-
To solve this problem,
42-
Add the `multiDexEnabled true` line to the `defaultConfig` section at `android/app/build.gradle file`
44+
45+
To solve this problem, add the `multiDexEnabled true` line to the `defaultConfig` section at `android/app/build.gradle file`
4346

4447
```
4548
android {
@@ -53,31 +56,36 @@ android {
5356

5457
For more information on multidex support, you can refer to the Android developer guide on [Configuring Multidex](https://developer.android.com/studio/build/multidex).
5558

56-
- If you are experiencing build failure issues while debugging due to Gradle/JDK/AGP version resolving try the following
57-
upgrading gradle version by CLI command
59+
If you are experiencing build failure issues while debugging due to Gradle/JDK/AGP version resolving try upgrading the gradle version by CLI command
60+
5861
```
5962
gradle wrapper --gradle-version <latest compatible version>
6063
```
61-
In any case above command fails then you need to edit the Gradle distribution reference in the `gradle/wrapper/gradle-wrapper.properties` file. The following example sets the Gradle version to 8.8 in the `gradle-wrapper.properties` file.
64+
65+
In case the above command fails, edit the Gradle distribution reference in the `gradle/wrapper/gradle-wrapper.properties` file. The following example sets the Gradle version to 8.8 in the `gradle-wrapper.properties` file.
66+
6267
```
6368
...
6469
distributionUrl = https\://services.gradle.org/distributions/gradle-8.8-bin.zip
6570
...
6671
```
67-
upgrade AGP by specifying the plugin version in the top-level `build.gradle` file. The following example sets the plugin to version 8.8.0 from the `build.gradle` file:
72+
73+
Upgrade AGP by specifying the plugin version in the top-level `build.gradle` file. The following example sets the plugin to version 8.8.0 from the `build.gradle` file:
74+
6875
```
6976
plugins {
7077
...
7178
id 'com.android.application' version '8.8.0' apply false
7279
id 'com.android.library' version '8.8.0' apply false
7380
...
7481
}
75-
7682
```
77-
For more information on Gradle and Java version compatibility, you can refer to [Compatibility Matrix](https://docs.gradle.org/current/userguide/compatibility.html).
78-
For more information on Gradle and Android Gradle Plugin compatibility, you can refer to [Update Gradle](https://developer.android.com/build/releases/gradle-plugin).
79-
Note : It is highly recommended that always ensure gradle and agp versions are compatible with your JDK version not the vice-versa and having atleast JDK 17 is recommmended.
8083

84+
For more information on:
85+
- Gradle and Java version compatibility, you can refer to [Compatibility Matrix](https://docs.gradle.org/current/userguide/compatibility.html).
86+
- Gradle and Android Gradle Plugin compatibility, you can refer to [Update Gradle](https://developer.android.com/build/releases/gradle-plugin).
87+
88+
Note : It is highly recommended that always ensure gradle and agp versions are compatible with your JDK version not the vice-versa and having atleast JDK 17 is recommmended.
8189

8290
## Web
8391

0 commit comments

Comments
 (0)