Android Studio怎么導(dǎo)出javadoc文檔操作

小編給大家分享一下Android Studio怎么導(dǎo)出javadoc文檔操作，相信大部分人都還不怎么了解，因此分享這篇文章給大家參考一下，希望大家閱讀完這篇文章后大有收獲，下面讓我們一起去了解一下吧！

Android是什么

Android是一種基于Linux內(nèi)核的自由及開放源代碼的操作系統(tǒng)，主要使用于移動(dòng)設(shè)備，如智能手機(jī)和平板電腦，由美國Google公司和開放手機(jī)聯(lián)盟領(lǐng)導(dǎo)及開發(fā)。

1、在Android studio中進(jìn)行打開一個(gè)項(xiàng)目的文件之后，然后進(jìn)行點(diǎn)擊Android stuio中菜單中的“tools”的選項(xiàng)。在彈出了下拉菜單中，進(jìn)行選中下拉菜單中的“Generate JavaDoc”的選項(xiàng)。

2、在彈出界面中 Output directory是你即將生產(chǎn)的javadoc文件的存儲(chǔ)位置,圖中1指示的位置；正常點(diǎn)擊ok即可；

但是如果有異常情況 比如空指針異?；蛘呶臋n亂碼

java.lang.NullPointerException 或者 java.nio.BufferOverflowException

等情況可在圖中2的位置即 Other command line arguments 后面輸入

-bootclasspath /Users/xiedingyuan/Documents/AndroidStudio/android-sdk-macosx/platforms/android-21/android.jar

jar指定你項(xiàng)目android.jar的位置就行。在Other command line arguments后輸入（參數(shù)之間勿忘空格）

-encoding utf-8 -charset utf-8

即可解決亂碼問題。

這樣設(shè)置后在點(diǎn)擊ok即可生產(chǎn)javadoc文檔。

補(bǔ)充知識(shí)：android 原apk替換androidManifest.xml的metaData的多渠道自動(dòng)打包

在已經(jīng)編譯出一個(gè)apk的情況下，其他的渠道只是改變androidManifest.xml的metaData信息，在這個(gè)情況下不需要再編譯apk，只需要修改androidManifest.xml；

實(shí)現(xiàn)的思路如下：

1.獲取源androidManifest.xml；因?yàn)閍pk里的androidManifest.xml是已經(jīng)編譯為二進(jìn)制的文件，不好修改；可以使用apktool把源apk反編譯得到androidManifest.xml的文本；

當(dāng)然上面可以二進(jìn)制的可以通過AXMLEditor.jar來修改，但這個(gè)修改metadata有點(diǎn)吃力，先簡單開始直接使用apktool。

2.修改metaData:反編譯得到androidManifest.xml的文本修改metaData信息；

3.得到二進(jìn)制的androidManifest.xml：通過apktool再次編譯為apk，解壓androidManifest.xml出來即可；

3.替換原apk的二進(jìn)制的androidManifest.xml，這樣得到是全新的apk；

4.簽名：刪除apk的META-INF，使用jarsigner進(jìn)行簽名；

5.字節(jié)對(duì)齊：通過zipalign進(jìn)行字節(jié)對(duì)齊；

利用android studio的product多渠道腳本、簽名等信息可實(shí)現(xiàn)修改androidManifest.xml；腳本代碼如下：

class ChannelBuildPlugin implements Plugin<Project> {
 
  String mSourceApkPath
  String mOutPutDir
  String mApkToolPath
  String mZip7ToolPath
  String mZipalignToolPath
  String mKeystore
  String mAlia
  String mStorepass
  String mSourceApkName
  String mProductName
  String mApplicationId
  void apply(Project project) {
 
    project.extensions.create("buildparam", ChannelBuildPluginExtension)
 
    project.task('autoBuildChannelProduct') << {
      println "autoBuildChannelProduct start "
      if (project.buildparam.sourceApkPath == null) {
        println "error !!!sourceApkPath == null"
        return
      }
      mSourceApkPath = project.buildparam.sourceApkPath
      File fp = new File(mSourceApkPath)
      if (!fp.exists()){
        throw new FileNotFoundException(mSourceApkPath)
      }
      mSourceApkName = fp.getName()
      mOutPutDir = project.buildparam.outPutDir
      File outDir = new File(mOutPutDir)
      if (!outDir.exists()){
        outDir.mkdirs()
      }
      mApkToolPath = project.buildparam.apkToolPath
      mZipalignToolPath = project.buildparam.zipalignToolPath
      mZip7ToolPath = project.buildparam.zip7ToolPath
      mKeystore = project.buildparam.keystore
      mAlia = project.buildparam.alia
      mStorepass = project.buildparam.storepass
      def signingConfigs
      project.copy {
        from "$mSourceApkPath"
        into "$mOutPutDir/workdir/sorceapk"
      }
      decodeApk()
      project.android.applicationVariants.all { variant -

if (variant.name.contains("Release")){
          mProductName = variant.flavorName;
          signingConfigs = variant.getSigningConfig()
 
 
          def metaConfig
          mApplicationId = variant.productFlavors.applicationId[0]
          println "applicationId:"+ mApplicationId
 
 
          for (def item:variant.productFlavors.manifestPlaceholders){
            metaConfig = item;
          }
 
 
          modifyMetaDataXML(metaConfig)
          packageApk()
          unzipAndroidManifest()
          replaceApkAndroidManifest()
          signCusApk(signingConfigs)
          zipalign(project)
 
 
          project.copy {
            String targetApk = "$mOutPutDir/workdir/sorceapk/"+mProductName +"_app-release_aligned"+".apk"
            if (mApkMd5 != null && !mApkMd5.equals("")){
              targetApk = "$mOutPutDir/workdir/sorceapk/"+mProductName +"_app-release_$mApkMd5"+".apk"
            }
            from "$targetApk"
            into "$mOutPutDir"
          }
        }

  }
    //重新簽名
    project.task('signApk') << {
    }
  }
  public void zipalign(Project project) {
    def apkFile = new File("$mOutPutDir/workdir/sorceapk/"+mProductName +"_app-release_aligned"+".apk")
    if (apkFile.exists()){
      apkFile.delete()
    }
    apkFile = new File("$mOutPutDir/workdir/sorceapk/$mSourceApkName")
    if (apkFile.exists()) {
      def sdkDir
      Properties properties = new Properties()
      File localProps = project.rootProject.file("local.properties")
      if (localProps.exists()) {
        properties.load(localProps.newDataInputStream())
        sdkDir = properties.getProperty("sdk.dir")
      } else {
        sdkDir = System.getenv("ANDROID_HOME")
      }
      if (sdkDir) {
        Properties prop = System.getProperties();
        String os = prop.getProperty("os.name");
        def cmdExt = os.contains("Windows") ? '.exe' : ''
        def argv = []
        argv << '-f'  //overwrite existing outfile.zip
        // argv << '-z'  //recompress using Zopfli
        argv << '-v'  //verbose output
        argv << '4'   //alignment in bytes, e.g. '4' provides 32-bit alignment
        argv << "$mOutPutDir/workdir/sorceapk/$mSourceApkName"
        argv << "$mOutPutDir/workdir/sorceapk/"+mProductName +"_app-release_aligned"+".apk" //output
        project.exec {
          commandLine "${sdkDir}/build-tools/${project.android.buildToolsVersion}/zipalign${cmdExt}"
          args argv
        }
        apkFile = new File("$mOutPutDir/workdir/sorceapk/"+mProductName +"_app-release_aligned"+".apk")
        if (!apkFile.exists()) {
          throw new FileNotFoundException("$mOutPutDir/workdir/sorceapk/"+mProductName +"_app-release_aligned"+".apk")
        }
      } else {
        throw new InvalidUserDataException('$ANDROID_HOME is not defined')
      }
    }
  }
  //對(duì)齊
  void alignApk() {
    println "alignApk"
    def fp = new File("$mOutPutDir/workdir/sorceapk/"+mProductName +"_app-release_aligned"+".apk")
    if (fp.exists()){
      fp.delete()
    }
    def args = [mZipalignToolPath,
          '-f',
          '-v',
          '4',
          "$mOutPutDir/workdir/sorceapk/$mSourceApkName",
          "$mOutPutDir/workdir/sorceapk/"+mProductName +"_app-release_aligned"+".apk"]
    println("zipalign...");
    def proc = args.execute()
    println "${proc.text}"
  }
  //簽名
  void signCusApk(def signingConfigs){
    println "signApk"
    println "delete META-INF start"
    def args = [mZip7ToolPath.replaceAll('/','\\\\'),
          'd',
          ("$mOutPutDir/workdir/sorceApk/"+mSourceApkName).replaceAll('/','\\\\'),
          "META-INF"]
    def proc = args.execute()
    println "${proc.text}"
    println "delete META-INF end"
    args = [JavaEnvUtils.getJdkExecutable('jarsigner'),
          '-verbose',
          '-sigalg', 'MD5withRSA',
          '-digestalg', 'SHA1',
          '-sigfile', 'CERT',
          '-tsa', 'http://timestamp.comodoca.com/authenticode',
          '-keystore', signingConfigs.storeFile,
          '-keypass', signingConfigs.keyPassword,
          '-storepass', signingConfigs.storePassword,
          "$mOutPutDir/workdir/sorceApk/$mSourceApkName",
          signingConfigs.keyAlias]
    println("JavaEnvUtils.getJdkExecutable...");
    proc = args.execute()
    println "${proc.text}"
  }
  //替換原始的二進(jìn)制化AndroidManifest
  void replaceApkAndroidManifest() {
    println "replaceApkAndroidManifest"
    def args = [mZip7ToolPath.replaceAll('/','\\\\'),
          'u',
          '-y',
          ("$mOutPutDir/workdir/sorceApk/"+mSourceApkName).replaceAll('/','\\\\'),
          ("$mOutPutDir/workdir/tempDir/AndroidManifest.xml").replaceAll('/','\\\\')]
    def proc = args.execute()
    println "${proc.text}"
  }
  //提取二進(jìn)制化AndroidManifest
  void unzipAndroidManifest() {
    println "unzipAndroidManifest"
    String apkPath = "$mOutPutDir/workdir/tempDir/app-modify-temp.apk"; // apk文件路徑
    ZipFile zf = new ZipFile(apkPath); // 建立zip文件
    InputStream is = zf.getInputStream(zf.getEntry("AndroidManifest.xml")); // 得到AndroidManifest.xml文件
    File targetFile = new File("$mOutPutDir/workdir/tempDir/AndroidManifest.xml");
    if (targetFile.exists()){
      targetFile.delete()
    }
    targetFile.createNewFile();
    FileOutputStream out = new FileOutputStream(targetFile);
    int length = 0;
    byte[] readByte =new byte[1024];
    try {
      while((length=is.read(readByte,0,1024))!=-1){
        out.write(readByte, 0, length);
      }
    } catch (Exception e2) {
      println "解壓文件失敗!"
      // logger.error("解壓文件失敗!",e2);
    }finally {
      is.close();
      out.close();
      zf.close()
    }
    if (targetFile.length() <= 0){
      throw new Throwable("$mOutPutDir/workdir/tempDir/AndroidManifest.xml unzipAndroidManifest error!!!")
    }
  }
  //打包apk，主要是實(shí)現(xiàn)AndroidManifest二進(jìn)制化
  void packageApk(){
    println "packageApk"
    def o = new File("$mOutPutDir/workdir/tempDir");
    o.deleteDir()
    o.mkdirs()
    Process p="$mApkToolPath b $mOutPutDir/workdir/decodeapk -o $mOutPutDir/workdir/tempDir/app-modify-temp.apk".execute()
    println "${p.text}"
    def fp = new File("$mOutPutDir/workdir/tempDir/app-modify-temp.apk")
    if (!fp.exists()){
      throw new Throwable("$mOutPutDir/workdir/tempDir/app-modify-temp.apk" + "not found !! packageApk error!!!")
    }
  }
  //修改AndroidManifest.xml的配置metaData
  boolean modifyMetaDataXML(Map<String,String> metaData) {
    println "modifyAMXML"
    println "metaData:"+metaData.toMapString()
    println "metaData:"+metaData.toMapString()
    if (metaData.size() <= 0) {
      println "mMetaSet size<= 0"
      return false;
    }
    DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
    // 如果創(chuàng)建的解析器在解析XML文檔時(shí)必須刪除元素內(nèi)容中的空格，則為true，否則為false
    dbf.setIgnoringElementContentWhitespace(false);
    try {
      /*
       * 創(chuàng)建文件對(duì)象
       */
      DocumentBuilder db = dbf.newDocumentBuilder();// 創(chuàng)建解析器，解析XML文檔
      Document doc = db.parse("$mOutPutDir/workdir/decodeapk/AndroidManifest.xml");
      // 使用dom解析xml文件
      /*
       * 歷遍列表，進(jìn)行XML文件的數(shù)據(jù)提取
       */
      // 根據(jù)節(jié)點(diǎn)名稱來獲取所有相關(guān)的節(jié)點(diǎn)org.w3c.dom.
      org.w3c.dom.NodeList sonlist = doc.getElementsByTagName("meta-data");//
      println "sonlist:" + sonlist.length
      // println "getAttributeNode:" + doc.getElementsByTagName("meta-data").getAttributeNode("android:name");
      for (org.w3c.dom.Node ne : sonlist) {//org.w3c.dom.
        org.w3c.dom.NamedNodeMap nnm = ne.attributes
        org.w3c.dom.Node metaKey = nnm.getNamedItem("android:name")
        // println "metaKey: $metaKey"
        if (metaKey != null) {
          // println "metaKey: "+metaKey.getNodeValue()
          String value = metaData.get(metaKey.getNodeValue())
          if (value == null){
            value = metaData.get(metaKey.getNodeValue().toLowerCase())
          }
          // println "mMetaSet: $value"
          if (value != null) {
            org.w3c.dom.Node metaValue = nnm.getNamedItem("android:value")
            metaValue.setNodeValue(value)
            println "modify $metaKey to $value"
          }
        }
      }
      try {
        TransformerFactory transformerFactory = TransformerFactory
            .newInstance();
        javax.xml.transform.Transformer transformer = transformerFactory.newTransformer();
        DOMSource source = new DOMSource(doc);
        StreamResult streamResult = new StreamResult(new File(
            "$mOutPutDir/workdir/decodeapk/AndroidManifest.xml"));
        transformer.transform(source, streamResult);
      } catch (Exception e) {
        e.printStackTrace();
        throw e;
      }
    } catch (Exception e) {
      e.printStackTrace();
      throw e;
    }
  }
  void decodeApk(){
    println "decodeApk"
    def outDir = new File("$mOutPutDir/workdir/decodeapk")
    outDir.deleteDir()
    Process p="$mApkToolPath d -f $mSourceApkPath -o $mOutPutDir/workdir/decodeapk".execute()
    println "${p.text}"
    File fp = new File("$mOutPutDir/workdir/decodeapk/AndroidManifest.xml")
    if (!fp.exists()){
      throw Exception("$mOutPutDir/workdir/decodeapk/AndroidManifest.xml not exist!!!error")
    }
  }
}
class ChannelBuildPluginExtension {
  String sourceApkPath
  String outPutDir
  String apkToolPath
  String zip7ToolPath
  String zipalignToolPath
  Map<String,String> metaSet
  String keystore
  String alia
  String storepass
  String channelConfig
  void channel(Closure clos){
    closure = clos
 
  }
}

下面是在主工程的腳本配置：

apply plugin:ChannelBuildPlugin
 
 
buildparam{
  sourceApkPath = "F:/svn/tv/app/app-release.apk"
  outPutDir = "F:/svn/tv/app"
  apkToolPath = "F:/svn/tv/app/apktool.bat"
  zip7ToolPath = "C:/Program Files/7-Zip/7z.exe"
}

這樣可以直接使用autoBuildChannelProduct這個(gè)任務(wù)即可編譯所有的渠道的包。

說明：

1.AndroidManifest.xml的metaData的key與manifestPlaceholders的key要對(duì)應(yīng)，可以大小寫不同；

2.android studio配置了自動(dòng)簽名，不然需要手動(dòng)配置簽名信息。

使用的場景特別是需要熱修復(fù)的情況，在多渠道的基準(zhǔn)包中，必須要保持基準(zhǔn)包的類及資源除AndroidManifest外都必須一樣的環(huán)境，這樣能保證所有渠道包均能熱修復(fù)；

后續(xù)改進(jìn)點(diǎn)：

1.不能修改applicationId、版本號(hào)等

2.不能使用默認(rèn)配置的，每個(gè)渠道都必須配置完所有的metaData信息

以上是“Android Studio怎么導(dǎo)出javadoc文檔操作”這篇文章的所有內(nèi)容，感謝各位的閱讀！相信大家都有了一定的了解，希望分享的內(nèi)容對(duì)大家有所幫助，如果還想學(xué)習(xí)更多知識(shí)，歡迎關(guān)注億速云行業(yè)資訊頻道！