小編給大家分享一下Android Studio怎么導(dǎo)出javadoc文檔操作,相信大部分人都還不怎么了解,因此分享這篇文章給大家參考一下,希望大家閱讀完這篇文章后大有收獲,下面讓我們一起去了解一下吧!
創(chuàng)新互聯(lián)2013年至今,先為延吉等服務(wù)建站,延吉等地企業(yè),進(jìn)行企業(yè)商務(wù)咨詢服務(wù)。為延吉企業(yè)網(wǎng)站制作PC+手機(jī)+微官網(wǎng)三網(wǎng)同步一站式服務(wù)解決您的所有建站問題。
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é)對齊:通過zipalign進(jìn)行字節(jié)對齊;
利用android studio的product多渠道腳本、簽名等信息可實(shí)現(xiàn)修改androidManifest.xml;腳本代碼如下:
class ChannelBuildPlugin implements Plugin{ 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') } } } //對齊 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(MapmetaData) { 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)建文件對象 */ 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 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要對應(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)容對大家有所幫助,如果還想學(xué)習(xí)更多知識(shí),歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道!