Browse Source

doc: wrap.

Because if the docs are for an awful thing, it doesn't mean they have
to look awful as well.
pull/482/head
Vladimír Vondruš 6 years ago
parent
commit
6f1f50d4b9
  1. 26
      doc/platforms-android.dox

26
doc/platforms-android.dox

@ -906,6 +906,8 @@ If you see the following warning when building with Android Gradle Plugin 3.6.0
and newer, it's because an @cb{.sh} $ANDROID_NDK_HOME @ce environment variable and newer, it's because an @cb{.sh} $ANDROID_NDK_HOME @ce environment variable
is defined. is defined.
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
$ gradle build $ gradle build
@ -940,6 +942,8 @@ android {
will result in the following error, or worse, a will result in the following error, or worse, a
@ref platforms-android-troubleshooting-no-signature-applicable "cryptic error about some closure". @ref platforms-android-troubleshooting-no-signature-applicable "cryptic error about some closure".
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
> Specified android.ndkVersion '19' does not have enough precision. Use major.minor.micro in version. > Specified android.ndkVersion '19' does not have enough precision. Use major.minor.micro in version.
@endcode @endcode
@ -983,6 +987,8 @@ gradle build
You can also put that directly into the `gradle.build` file, although that's You can also put that directly into the `gradle.build` file, although that's
not recommended because it hardcodes your local system setup in the project: not recommended because it hardcodes your local system setup in the project:
@m_class{m-console-wrap}
@code{.gradle} @code{.gradle}
android { android {
... ...
@ -1089,6 +1095,8 @@ but why is that reported by a throwing exception 1000 stack frames deep in some
totally random ungoogleable API is just beyond me. Anyway --- the following totally random ungoogleable API is just beyond me. Anyway --- the following
may happen with Android Gradle plugin 2.3.3: may happen with Android Gradle plugin 2.3.3:
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
> Failed to notify project evaluation listener. > Failed to notify project evaluation listener.
> org.gradle.api.tasks.compile.CompileOptions.setBootClasspath(Ljava/lang/String;)V > org.gradle.api.tasks.compile.CompileOptions.setBootClasspath(Ljava/lang/String;)V
@ -1096,6 +1104,8 @@ may happen with Android Gradle plugin 2.3.3:
While this with 3.0.0: While this with 3.0.0:
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
> Failed to notify project evaluation listener. > Failed to notify project evaluation listener.
> org.gradle.api.internal.TaskInputsInternal.property(Ljava/lang/String;Ljava/lang/Object;)Lorg/gradle/api/tasks/TaskInputs; > org.gradle.api.internal.TaskInputsInternal.property(Ljava/lang/String;Ljava/lang/Object;)Lorg/gradle/api/tasks/TaskInputs;
@ -1103,6 +1113,8 @@ While this with 3.0.0:
This for 3.3.0: This for 3.3.0:
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
> Failed to notify project evaluation listener. > Failed to notify project evaluation listener.
> org.gradle.api.file.ProjectLayout.directoryProperty(Lorg/gradle/api/provider/Provider;)Lorg/gradle/api/file/DirectoryProperty; > org.gradle.api.file.ProjectLayout.directoryProperty(Lorg/gradle/api/provider/Provider;)Lorg/gradle/api/file/DirectoryProperty;
@ -1128,6 +1140,8 @@ buildscript {
Android Gradle plugin 3.6 and newer may *greet* you with the following when Android Gradle plugin 3.6 and newer may *greet* you with the following when
doing a fresh build: doing a fresh build:
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
$ gradle build $ gradle build
@ -1177,6 +1191,8 @@ keep it there.
Gradle might refuse to build a project if SDK licenses are not accepted, with Gradle might refuse to build a project if SDK licenses are not accepted, with
an error that might look like this: an error that might look like this:
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
$ gradle build $ gradle build
@ -1209,6 +1225,8 @@ If the tool blows up with the following error, it's again because the Java
version is too new, see @ref platforms-android-troubleshooting-java8 "above" version is too new, see @ref platforms-android-troubleshooting-java8 "above"
for a solution: for a solution:
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
Exception in thread "main" java.lang.NoClassDefFoundError: javax/xml/bind/annotation/XmlSchema Exception in thread "main" java.lang.NoClassDefFoundError: javax/xml/bind/annotation/XmlSchema
at com.android.repository.api.SchemaModule$SchemaModuleVersion.<init>(SchemaModule.java:156) at com.android.repository.api.SchemaModule$SchemaModuleVersion.<init>(SchemaModule.java:156)
@ -1217,6 +1235,8 @@ Exception in thread "main" java.lang.NoClassDefFoundError: javax/xml/bind/annota
@subsection platforms-android-troubleshooting-marshalling-nonexistent-xml Gradle complains about an exception while marshalling some XML file that doesn't exist @subsection platforms-android-troubleshooting-marshalling-nonexistent-xml Gradle complains about an exception while marshalling some XML file that doesn't exist
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
$ gradle build $ gradle build
@ -1233,6 +1253,8 @@ if there are no licenses left to sign.
@subsection platforms-android-troubleshooting-no-signature-applicable Gradle fails because no signature of method is applicable for argument types @subsection platforms-android-troubleshooting-no-signature-applicable Gradle fails because no signature of method is applicable for argument types
@m_class{m-console-wrap}
@code{.shell-session} @code{.shell-session}
$ gradle build $ gradle build
@ -1268,8 +1290,8 @@ and [android-platform-25](https://aur.archlinux.org/packages/android-platform-25
@section platforms-android-obsolete-troubleshooting Obsolete troubleshooting @section platforms-android-obsolete-troubleshooting Obsolete troubleshooting
These issues should no longer appear in practice with reasonably recent These issues should no longer appear in practice with reasonably recent
versions of Android tools, however are still kept <del>to remind us everything versions of Android tools, however are still kept <s>to remind us everything
used to be even worse than it is now</del> in case your project keeps using the used to be even worse than it is now</s> in case your project keeps using the
older versions (which is recommended for sanity, there's not many things worse older versions (which is recommended for sanity, there's not many things worse
than upgrading Android NDK). than upgrading Android NDK).

Loading…
Cancel
Save