[Cronet] Generate Javadoc

This CL generate Javadoc as a part of cronet_package.

BUG=428935

Review URL: https://codereview.chromium.org/1148263004

Cr-Commit-Position: refs/heads/master@{#333162}

components/cronet.gypi

@@ -535,6 +535,19 @@
                 '<@(_outputs)',
               ],
             },
+            {
+              'action_name': 'generate javadoc',
+              'inputs': ['cronet/tools/generate_javadoc.py'] ,
+              'outputs': ['<(package_dir)/javadoc'],
+              'action': [
+                'python',
+                '<@(_inputs)',
+                '--source-dir=src',
+                '--output-dir=<(package_dir)/javadoc',
+                '--working-dir=cronet/android/java',
+              ],
+              'message': 'Generating Javadoc',
+            },
           ],
           'copies': [
             {

components/cronet/android/java/build.xml

+<project>
+  <target name="doc" description="generate documentation">
+      <javadoc destdir="${doc.dir}"
+               windowtitle="Cronet API"
+               nohelp="yes"
+               notree="yes"
+               nodeprecated="yes"
+               >
+        <fileset dir="${source.dir}" defaultexcludes="yes">
+          <include name="**/*.java"/>
+          <!-- exclude legacy API -->
+          <exclude name="**/Chromium*.java"/>
+          <exclude name="**/ChunkedWritableByteChannel*.java"/>
+          <exclude name="**/HttpUrl*.java"/>
+        </fileset>
+      </javadoc>
+  </target>
+</project>

components/cronet/tools/generate_javadoc.py

+#!/usr/bin/env python
+#
+# Copyright 2015 The Chromium Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+import fnmatch
+import optparse
+import os
+import sys
+
+REPOSITORY_ROOT = os.path.abspath(os.path.join(
+    os.path.dirname(__file__), '..', '..', '..'))
+
+sys.path.append(os.path.join(REPOSITORY_ROOT, 'build/android/gyp/util'))
+import build_utils
+
+
+def GenerateJavadoc(options):
+  source_dir = options.source_dir
+  output_dir = options.output_dir
+  working_dir = options.working_dir
+
+  build_utils.DeleteDirectory(output_dir)
+  build_utils.MakeDirectory(output_dir)
+  javadoc_cmd = ['ant', '-Dsource.dir=' + source_dir,
+             '-Ddoc.dir=' + os.path.abspath(output_dir), 'doc']
+  build_utils.CheckOutput(javadoc_cmd, cwd=working_dir)
+
+
+def main():
+  parser = optparse.OptionParser()
+  parser.add_option('--source-dir', help='Source directory')
+  parser.add_option('--output-dir', help='Directory to put javadoc')
+  parser.add_option('--working-dir', help='Working directory')
+
+  options, _ = parser.parse_args()
+
+  GenerateJavadoc(options)
+
+if __name__ == '__main__':
+  sys.exit(main())
+