Use -linkoffline to provide the Android Javadoc package list (flutter/engine#29629)

engine/src/flutter/shell/platform/android/BUILD.gn

@@ -544,7 +544,7 @@ zip_bundle("flutter_jar_zip") {
 }
 
 action("gen_android_javadoc") {
-  script = "//flutter/tools/gen_javadoc.py"
+  script = "//flutter/tools/javadoc/gen_javadoc.py"
   sources = android_java_sources + embedding_dependencies_jars
 
   outputs = [ "$target_gen_dir/javadocs" ]

engine/src/flutter/tools/javadoc/android_reference/package-list

@@ -0,0 +1,238 @@
+android
+android.accessibilityservice
+android.accounts
+android.animation
+android.annotation
+android.app
+android.app.admin
+android.app.appsearch
+android.app.appsearch.exceptions
+android.app.assist
+android.app.backup
+android.app.blob
+android.app.job
+android.app.people
+android.app.role
+android.app.slice
+android.app.usage
+android.appwidget
+android.bluetooth
+android.bluetooth.le
+android.companion
+android.content
+android.content.pm
+android.content.pm.verify.domain
+android.content.res
+android.content.res.loader
+android.database
+android.database.sqlite
+android.drm
+android.gesture
+android.graphics
+android.graphics.drawable
+android.graphics.drawable.shapes
+android.graphics.fonts
+android.graphics.pdf
+android.graphics.text
+android.hardware
+android.hardware.biometrics
+android.hardware.camera2
+android.hardware.camera2.params
+android.hardware.display
+android.hardware.fingerprint
+android.hardware.input
+android.hardware.lights
+android.hardware.usb
+android.icu.lang
+android.icu.math
+android.icu.number
+android.icu.text
+android.icu.util
+android.inputmethodservice
+android.location
+android.location.provider
+android.media
+android.media.audiofx
+android.media.browse
+android.media.effect
+android.media.metrics
+android.media.midi
+android.media.projection
+android.media.session
+android.media.tv
+android.mtp
+android.net
+android.net.eap
+android.net.http
+android.net.ipsec.ike
+android.net.ipsec.ike.exceptions
+android.net.nsd
+android.net.rtp
+android.net.sip
+android.net.ssl
+android.net.vcn
+android.net.wifi
+android.net.wifi.aware
+android.net.wifi.hotspot2
+android.net.wifi.hotspot2.omadm
+android.net.wifi.hotspot2.pps
+android.net.wifi.p2p
+android.net.wifi.p2p.nsd
+android.net.wifi.rtt
+android.nfc
+android.nfc.cardemulation
+android.nfc.tech
+android.opengl
+android.os
+android.os.health
+android.os.storage
+android.os.strictmode
+android.preference
+android.print
+android.print.pdf
+android.printservice
+android.provider
+android.renderscript
+android.sax
+android.se.omapi
+android.security
+android.security.identity
+android.security.keystore
+android.service.autofill
+android.service.carrier
+android.service.chooser
+android.service.controls
+android.service.controls.actions
+android.service.controls.templates
+android.service.dreams
+android.service.media
+android.service.notification
+android.service.quickaccesswallet
+android.service.quicksettings
+android.service.restrictions
+android.service.textservice
+android.service.voice
+android.service.vr
+android.service.wallpaper
+android.speech
+android.speech.tts
+android.system
+android.telecom
+android.telephony
+android.telephony.cdma
+android.telephony.data
+android.telephony.emergency
+android.telephony.euicc
+android.telephony.gsm
+android.telephony.ims
+android.telephony.ims.feature
+android.telephony.mbms
+android.test
+android.test.mock
+android.test.suitebuilder
+android.test.suitebuilder.annotation
+android.text
+android.text.format
+android.text.method
+android.text.style
+android.text.util
+android.transition
+android.util
+android.util.proto
+android.view
+android.view.accessibility
+android.view.animation
+android.view.autofill
+android.view.contentcapture
+android.view.displayhash
+android.view.inputmethod
+android.view.inspector
+android.view.textclassifier
+android.view.textservice
+android.view.translation
+android.webkit
+android.widget
+android.widget.inline
+android.window
+dalvik.annotation
+dalvik.bytecode
+dalvik.system
+java.awt.font
+java.beans
+java.io
+java.lang
+java.lang.annotation
+java.lang.invoke
+java.lang.ref
+java.lang.reflect
+java.math
+java.net
+java.nio
+java.nio.channels
+java.nio.channels.spi
+java.nio.charset
+java.nio.charset.spi
+java.nio.file
+java.nio.file.attribute
+java.nio.file.spi
+java.security
+java.security.acl
+java.security.cert
+java.security.interfaces
+java.security.spec
+java.sql
+java.text
+java.time
+java.time.chrono
+java.time.format
+java.time.temporal
+java.time.zone
+java.util
+java.util.concurrent
+java.util.concurrent.atomic
+java.util.concurrent.locks
+java.util.function
+java.util.jar
+java.util.logging
+java.util.prefs
+java.util.regex
+java.util.stream
+java.util.zip
+javax.crypto
+javax.crypto.interfaces
+javax.crypto.spec
+javax.microedition.khronos.egl
+javax.microedition.khronos.opengles
+javax.net
+javax.net.ssl
+javax.security.auth
+javax.security.auth.callback
+javax.security.auth.login
+javax.security.auth.x500
+javax.security.cert
+javax.sql
+javax.xml
+javax.xml.datatype
+javax.xml.namespace
+javax.xml.parsers
+javax.xml.transform
+javax.xml.transform.dom
+javax.xml.transform.sax
+javax.xml.transform.stream
+javax.xml.validation
+javax.xml.xpath
+junit.framework
+junit.runner
+org.apache.http.conn
+org.apache.http.conn.scheme
+org.apache.http.conn.ssl
+org.apache.http.params
+org.json
+org.w3c.dom
+org.w3c.dom.ls
+org.xml.sax
+org.xml.sax.ext
+org.xml.sax.helpers
+org.xmlpull.v1
+org.xmlpull.v1.sax2
+

engine/src/flutter/tools/javadoc/gen_javadoc.py

@@ -11,15 +11,15 @@ import sys
 
 ANDROID_SRC_ROOT = 'flutter/shell/platform/android'
 
+SCRIPT_DIR = os.path.dirname(os.path.realpath(__file__))
 
 def JavadocBin():
-  script_path = os.path.dirname(os.path.realpath(__file__))
   if sys.platform == 'darwin':
-    return os.path.join(script_path, '..', '..', 'third_party', 'java', 'openjdk', 'Contents', 'Home', 'bin', 'javadoc')
+    return os.path.join(SCRIPT_DIR, '..', '..', '..', 'third_party', 'java', 'openjdk', 'Contents', 'Home', 'bin', 'javadoc')
   elif sys.platform.startswith(('cygwin', 'win')):
-    return os.path.join(script_path, '..', '..', 'third_party', 'java', 'openjdk', 'bin', 'javadoc.exe')
+    return os.path.join(SCRIPT_DIR, '..', '..', '..', 'third_party', 'java', 'openjdk', 'bin', 'javadoc.exe')
   else :
-    return os.path.join(script_path, '..', '..', 'third_party', 'java', 'openjdk', 'bin', 'javadoc')
+    return os.path.join(SCRIPT_DIR, '..', '..', '..', 'third_party', 'java', 'openjdk', 'bin', 'javadoc')
 
 
 def main():
@@ -70,11 +70,13 @@ def main():
     'io.flutter.view',
   ]
 
+  android_package_list = os.path.join(SCRIPT_DIR, 'android_reference')
+
   command = [
     JavadocBin(),
     '-classpath', ':'.join(classpath),
     '-d', args.out_dir,
-    '-link', 'https://developer.android.com/reference/',
+    '-linkoffline', 'https://developer.android.com/reference/', android_package_list,
     '-source', '1.8',
   ] + packages