Android Studio，使用技巧，问题记录和一些好用的插件
DomCedeno
8年前
<h2><strong>使用技巧</strong></h2> <h2><strong>根据不同 buildType 使用不同包名和资源</strong></h2> <p>比如在 production，development，qa 不同阶段使用不同的 packageName 和 authority，在 build.gradle 中配置如下：</p> <pre> <code class="language-java">productFlavors { production { applicationId = "com.myapp.app" resValue "string", "authority", "com.非死book.app.非死bookContentProvider5435651423234" } development { applicationId = "com.myapp.development" resValue "string", "authority", "com.非死book.app.非死bookContentProvider2134564533421" } qa { applicationId = "com.myapp.qa" resValue "string", "authority", "com.非死book.app.非死bookContentProvider29831237981287319" } }</code></pre> <p>通过 resValue 方法设置的资源会在 R 文件生成对应的 id。</p> <p>在 AndroidManifest.xml 中使用 authority 字符串</p> <pre> <code class="language-java"><provider android:name="com.非死book.非死bookContentProvider" android:authorities="@string/authority" android:exported="true" /></code></pre> <h2><strong>替换 AndroidManifest.xml 中的占位符</strong></h2> <p>使用 manifestPlaceholders 可以定义相关字段替换 AndroidManifest.xml 中的占位符。</p> <p>格式：manifestPlaceholders = [ key1:"value1", key2:"value2", ... ]</p> <p>下面是一个示例：</p> <pre> <code class="language-java">android { defaultConfig { def authorityName = "com.linchaolong.android.app.droidplugin_stub" manifestPlaceholders = [ authorityName:"${authorityName}", key:"value", ] } }</code></pre> <p>说明：manifestPlaceholders 是一个 map。</p> <p>在 AndroidManifest.xml 中通过 ${key} 引用相关字段。</p> <h2><strong>自定义 BuildConfig 字段</strong></h2> <p>通过 buildConfigField 可以添加自定义的字段到 BuildConfig 中。</p> <p>格式：buildConfigField "type", "key", "value"</p> <pre> <code class="language-java">android { defaultConfig{ def authority = "com.linchaolong.android.app" buildConfigField "String", "AUTHORITY", "\"${authority }\"" buildConfigField "int", "FOO", "42" buildConfigField "String", "FOO_STRING", "\"foo\"" buildConfigField "boolean", "LOG", "true" } }</code></pre> <p>def 操作符可用于定义变量和函数。</p> <p>在 java 代码中你可以通过 BuildConfig.key 访问对应的字段，比如： BuildConfig.AUTHORITY 访问 AUTHORITY 常量。</p> <h2><strong>统一管理不同 module 依赖库的版本</strong></h2> <ol> <li> <p>新建一个 config.gradle 在工程根目录下，并添加一些全局的配置：</p> <pre> <code class="language-java">allprojects { repositories { jcenter() } ext{ compileSdkVersion = 25 buildToolsVersion = "25.0.0" minSdkVersion = 14 targetSdkVersion = 25 support = '25.0.0' play_services = '9.8.0' rxjava = '2.0.1' // Json gson = '2.8.0' // HTTP okhttp = '3.4.1' retrofit = '2.1.0' glide = '3.7.0' // DEPS INJECTION dagger = '2.6' // VIEW INJECTION butterknife = '8.4.0' // DEBUG stetho = '1.4.1' } }</code></pre> </li> <li> <p>然后在 project-level 下的 build.gradle 添加如下配置应用 config.gradle :</p> <pre> <code class="language-java">apply from: rootProject.file('config.gradle')</code></pre> </li> <li> <p>在各 module 的 build.gradle 引用 ext 中的字段</p> <ul> <li> <p>在 android 块中引用 ext 中的字段</p> <pre> <code class="language-java">android { compileSdkVersion project.ext.compileSdkVersion buildToolsVersion project.ext.buildToolsVersion defaultConfig { applicationId "linchaolong.demo" minSdkVersion project.ext.minSdkVersion targetSdkVersion project.ext.targetSdkVersion def QQ_APPID = rootProject.ext.QQ_APPID manifestPlaceholders = [QQ_APPID:"${QQ_APPID}"] } }</code></pre> </li> <li> <p>在 dependencies 块下引用 ext 中的字段</p> <pre> <code class="language-java">dependencies { compile "com.android.support:appcompat-v7:$support" // Debug compile "com.非死book.stetho:stetho:$stetho" compile "com.非死book.stetho:stetho-okhttp3:$stetho" debugCompile "com.非死book.stetho:stetho-js-rhino:$stetho" // Json compile "com.google.code.gson:gson:$gson" // Butterknife compile "com.jakewharton:butterknife:$butterknife" annotationProcessor "com.jakewharton:butterknife-compiler:$butterknife" // RxJava compile "io.reactivex.rxjava2:rxjava:$rxjava" compile "io.reactivex.rxjava2:rxandroid:$rxjava" }</code></pre> <p>严重注意：引用 ext 中字段时要使用双引号，不能是单引号。格式为 ${key} 或 $key</p> </li> </ul> </li> </ol> <h2><strong>建立各 Module 共享的配置</strong></h2> <p>比如，这里想统一设置各 Module 支持的 so 库架构，可以在工程目录下新建一个 module.gradle 存放共享的配置，配置如下：</p> <pre> <code class="language-java">// Module 共享的配置 android { defaultConfig { ndk { //设置支持的SO库架构 abiFilters 'armeabi-v7a' //, 'armeabi' , 'x86', 'x86_64', 'arm64-v8a' } } }</code></pre> <p>然后，在各 Module 下的 build.gradle 配置中应用 module.gradle，示例如下：</p> <pre> <code class="language-java">apply plugin: 'com.android.application' apply from: rootProject.file('module.gradle')</code></pre> <h2><strong>自定义 release apk 名称</strong></h2> <p>修改 build.gradle 配置如下：</p> <pre> <code class="language-java">android { buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' signingConfig signingConfigs.release // 自定义 release apk 名称 applicationVariants.all { variant -> variant.outputs.each { output -> def releaseTime = new Date().format('yyyyMMddHHmmss') // 修改 release apk 名称，app_1.0_20170108224145.apk def fileName = output.outputFile.name.replace("-release", "_${defaultConfig.versionName}_"+releaseTime) output.outputFile = new File(output.outputFile.parent, fileName) } } } } }</code></pre> <h2><strong>手动 build 工程</strong></h2> <p>我们应该都或多或少遇到过这种情况，当我们第一次打开一个项目时，该项目会先下载相关的依赖项，如果很多的话，将会等很久，而且又不能做其他操作，这样太浪费时间了。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/5f2ce2f0706de3f3e09e0f8e782302d2.png"></p> <p style="text-align:center">Image</p> <p>下面说说如何在命令行中手动 build 工程：</p> <p>每个 android studio 工程下应该都会有 gradlew.bat （Windows） 和 gradlew （Mac） 两个脚本文件，我们可以打开命令行，cd 到工程目录下，通过执行 gradlew.bat build 命令，手动去构建工程。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/8545f221d71f3c12082b51d16927ec2c.png"></p> <p style="text-align:center">Image</p> <p>通过在命令行构建工程可以不影响当前工作，而且构建完成后再使用 android studio 打开该工程将会比较快。</p> <h2><strong>手动下载和替换本地 gradle/jar</strong></h2> <p>build 过程很慢？这个多数是由于个别依赖项下载速度过慢引起的，有时还会卡在某个点，但我们可以通过手动下载替换解决该问题。</p> <p>这里分为两个部分，一个是 gradle 的下载替换，一个是依赖库的下载替换。</p> <p>我们通过在命令行执行 gradlew.bat build 命令可以看到相关依赖的下载地址：</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/ba5d9f7143ff003e5d965cc5b13bd718.png"></p> <p style="text-align:center">Paste_Image.png</p> <p>正常下载速度可能只有几十KB（可能更低...），但是如果我们把下载链接 copy 到迅雷下载，它是这样的：</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/43acbfa9d4fbd2859c9c66ad04413b35.png"></p> <p style="text-align:center">Paste_Image.png</p> <p>在 windows 下，gradle 存放目录就在 C:\Users\用户名\.gradle\wrapper\dists 下。下载完成后，把 *.lck 和 *.zip.part 文件删掉，替换为我们刚下载的 .zip 。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/a3db2a27a0be3b53b91ee00af7cdd952.png"></p> <p style="text-align:center">Paste_Image.png</p> <p>重新执行 gradlew.bat build 命令可以看到它将会自动解压该 *.zip 文件。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/776b8f9e375f82c4940b638d3ce7b595.png"></p> <p style="text-align:center">Paste_Image.png</p> <p>在 windows 下，依赖库的存放目录就在 C:\Users\用户名\.gradle\caches 。jar文件的下载替换也是同理，比如我这里下载一个 common-25.3.0-alpha2.jar ，下载完成后把它放在 common-25.3.0-alpha2.pom 同级目录下，重新执行 build 命令即可。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/03a4e214c0e8f56b41472d6dd79c29b0.png"></p> <p style="text-align:center">Paste_Image.png</p> <p>这里的目录路径可能和你的不太一样，可以使用 Everything 搜索一下文件名。</p> <h2><strong>构建一个aar文件</strong></h2> <p>如果你的 module 声明为 android library（即在 build.gradle 文件中使用 apply plugin：'com.android.library' ），它将在构建时输出 .aar 文件，在 module 的 build/outputs/aar 目录下。</p> <p>你可以选择该 module ，然后 Build —> Make Module * 构建该 module。或者使用 gradlew.bat build 命令构建工程。然后就可以在输出目录下找到 .aar 文件了。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/8e122b0f52e138e25c0abfc210848fb0.png"></p> <p style="text-align:center">Paste_Image.png</p> <h2><strong>引用 aar 文件</strong></h2> <p>假设把 aar 文件放在 module 下的 libs 目录。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/3f6f3c344b4c38dae6380a88c75417b4.png"></p> <p style="text-align:center">Paste_Image.png</p> <p>引用本 module 的 aar 文件 build.gradle 配置如下：</p> <pre> <code class="language-java">repositories{ flatDir{ dirs 'libs' } } dependencies { compile(name:'stetho_realm-release', ext:'aar') }</code></pre> <p>如果是引用其他 module 的 aar 文件，还要在本 module 的 build.gradle 中配置被引用 module 的 aar 目录，否则会找不到文件。</p> <pre> <code class="language-java">repositories { flatDir { dirs project(':Library').file('libs') } }</code></pre> <p>多个目录使用 “,” 分隔</p> <h2><strong>快捷键</strong></h2> <p>由于 Android Studio 是基于 IDEA 的，所以很多快捷键是通用的。</p> <h2><strong>全局替换</strong></h2> <p>Edit —> Find —> Replace in Path</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/e26d1f9d2c0ceb39464d2dca9cb490ca.png"></p> <p style="text-align:center">Replace in Path</p> <h2><strong>动态调试app</strong></h2> <p>1.在源码先打断点，点击挂接 Android 进程按钮。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/8ab03d01d9f55ee5a6941e08902be787.png"></p> <p style="text-align:center">Paste_Image.png</p> <p>2.选择 app 进程，点OK，开始调试。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/fa7dee0117d7c0605750943423aa3a4b.png"></p> <p style="text-align:center">Paste_Image.png</p> <h2><strong>一些好用的插件</strong></h2> <p>插件安装说明:</p> <ul> <li>在线安装<br> 打开 File ——> Settings ——> Plugins ——> Browse repositories... 搜索插件名，点 Install 下载安装，安装完成后重启生效。</li> <li>离线安装<br> 下载插件安装包，打开 File ——> Settings ——> Plugins ——> Install plugin from disk... 选择插件安装包，安装完成后重启生效。</li> </ul> <h2><strong>GsonFormat</strong></h2> <p>GsonFormat 是一个可以快速将 JSON 字符串转换为 Entity 类的插件。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/1425cf52bc482b946fbe08f13afc7fd0.gif"></p> <p><strong>GsonFormat</strong></p> <p>使用说明： Alt + S 调出 GsonFormat，或者 Alt Insert + GsonFormat 。</p> <p>在 Settings 中选择 filed(public) ，Enter 保存修改，可以只生成 public 字段，不生成一大堆的 getter 和 setter，代码会更简洁些。</p> <p>插件地址： <a href="/misc/goto?guid=4959741067679564597" rel="nofollow,noindex">https://plugins.jetbrains.com/idea/plugin/7654-gsonformat</a></p> <p>Github地址： <a href="/misc/goto?guid=4958875619111090072" rel="nofollow,noindex">https://github.com/zzz40500/GsonFormat</a></p> <h2><strong>Android ButterKnife Zelezny</strong></h2> <p>Android ButterKnife Zelezny 是 Android 下的注解框架 ButterKnife 的辅助插件，用于一键生成 Butterknife 视图注入代码。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/84b66a1c0caee9c008da2a266095c9a7.gif"></p> <p><strong>Android ButterKnife Zelezny</strong></p> <p>使用说明：把光标停在 setContentView(R.layout.activity_settings) 那行中的 activity_settings<br> 上右键选择 Generate ( alt + insert ）→ Generate Butterknife Injections</p> <p>注意：需要把光标停在 layout 的名称上才能调出 ButterKnife Zelezny 。</p> <p>ButterKnife： <a href="/misc/goto?guid=4958961775931067718" rel="nofollow,noindex">https://github.com/JakeWharton/butterknife</a></p> <p>插件地址： <a href="/misc/goto?guid=4959741067824580679" rel="nofollow,noindex">https://plugins.jetbrains.com/idea/plugin/7369-android-butterknife-zelezny</a></p> <p>Github地址： <a href="/misc/goto?guid=4958875618985371190" rel="nofollow,noindex">https://github.com/avast/android-butterknife-zelezny</a></p> <h2><strong>ECTranslation</strong></h2> <p>Android Studio 翻译插件，可以将英文翻译为中文。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/ab87c1dec949bce33e44799ee1c60f73.jpg"></p> <p><strong>ECTranslation</strong></p> <p>使用说明：选中要翻译的内容，选择 Edit ——> Translate 或者按下 command + I （我这里设置为 Shift + I ）。</p> <p>修改快捷键： Preferences -> Keymap -> 搜索Translate - > 右键 add Keyboard Shortcut . 输入你想要的快捷键即可。</p> <p>插件地址： <a href="/misc/goto?guid=4959741067939458593" rel="nofollow,noindex">https://plugins.jetbrains.com/idea/plugin/8469-ectranslation</a></p> <p>Github地址： <a href="/misc/goto?guid=4959714115159123733" rel="nofollow,noindex">https://github.com/Skykai521/ECTranslation</a></p> <h2><strong>问题记录</strong></h2> <h2><strong>Error:The number of method references in a .dex file cannot exceed 64K.</strong></h2> <p>这是错误是因为应用的方法数已经超过了64K了，在 class 转换 dex 文件时报错了。一个 dex 文件的最大方法数是65536，所以这时候要启用 Multidex。</p> <p>1.app 的 build.gradle 添加如下配置</p> <pre> <code class="language-java">android { defaultConfig { // 启用 multidex 支持. multiDexEnabled true } } dependencies { compile 'com.android.support:multidex:1.0.1' }</code></pre> <p>2.在 AndroidManifest.xml 下配置 MultiDexApplication</p> <pre> <code class="language-java"><?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.android.multidex.myapplication"> <application ... android:name="android.support.multidex.MultiDexApplication"> ... </application> </manifest></code></pre> <p>如果是自定义了 Application 则让其继承 MultiDexApplication。</p> <p>官方文档： <a href="/misc/goto?guid=4959653310437223048" rel="nofollow,noindex">https://developer.android.com/tools/building/multidex.html</a></p> <h2><strong>Error: "*" is not translated in "en" (English) [MissingTranslation]</strong></h2> <p>这种错误一般出现在打包的时候，表示 strings.xml 中缺失本地化的字符串资源。</p> <p>这个错误有两个解决方案：</p> <ol> <li>在 values\strings.xml 或出问题的 strings.xml 中添加如下配置： <pre> <code class="language-java"><resources xmlns:tools="http://schemas.android.com/tools" tools:locale="en"></code></pre> </li> <li>在 values\strings.xml 或出问题的 strings.xml 中添加如下配置： <pre> <code class="language-java"><resources xmlns:tools="http://schemas.android.com/tools" tools:ignore="MissingTranslation" ></code></pre> </li> </ol> <p>缺失的本地化字符串资源会使用默认字符串资源。</p> <h2><strong>Could not find Library</strong></h2> <p>日志如下：</p> <pre> <code class="language-java">Error:A problem occurred configuring project ':app'. > Could not resolve all dependencies for configuration ':app:_debugCompile'. > Could not find com.android.support:appcompat-v7:22.2.0. Searched in the following locations: https://jcenter.bintray.com/com/android/support/appcompat-v7/22.2.0/appcompat-v7-22.2.0.pom https://jcenter.bintray.com/com/android/support/appcompat-v7/22.2.0/appcompat-v7-22.2.0.jar file:/D:/AndroidDeveloper/adt-bundle-windows-x86-20130917/sdk/extras/google/m2repository/com/android/support/appcompat-v7/22.2.0/appcompat-v7-22.2.0.pom file:/D:/AndroidDeveloper/adt-bundle-windows-x86-20130917/sdk/extras/google/m2repository/com/android/support/appcompat-v7/22.2.0/appcompat-v7-22.2.0.jar Required by: HelloWorld:app:unspecified</code></pre> <p>解决办法：更新你的 Android Support Library 和 Android Support Repository.</p> <h2><strong>修改 applicationId 后启动出现ClassNotFoundException</strong></h2> <p>日志如下：</p> <pre> <code class="language-java">E/AndroidRuntime: FATAL EXCEPTION: main Process: com.linchaolong.android.app, PID: 10690 java.lang.RuntimeException: Unable to instantiate application com.android.tools.fd.runtime.BootstrapApplication: java.lang.IllegalStateException: java.lang.ClassNotFoundException: com.linchaolong.android.app.MyApplication at android.app.LoadedApk.makeApplication(LoadedApk.java:565) at android.app.ActivityThread.handleBindApplication(ActivityThread.java:4545) at android.app.ActivityThread.access$1500(ActivityThread.java:154) at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1369) at android.os.Handler.dispatchMessage(Handler.java:102) at android.os.Looper.loop(Looper.java:135) at android.app.ActivityThread.main(ActivityThread.java:5275) at java.lang.reflect.Method.invoke(Native Method) at java.lang.reflect.Method.invoke(Method.java:372) at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:909) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:704) Caused by: java.lang.IllegalStateException: java.lang.ClassNotFoundException: com.linchaolong.demo.App at com.android.tools.fd.runtime.BootstrapApplication.createRealApplication(BootstrapApplication.java:220) at com.android.tools.fd.runtime.BootstrapApplication.attachBaseContext(BootstrapApplication.java:239) at android.app.Application.attach(Application.java:185) at android.app.Instrumentation.newApplication(Instrumentation.java:996) at android.app.Instrumentation.newApplication(Instrumentation.java:980) at android.app.LoadedApk.makeApplication(LoadedApk.java:560) at android.app.ActivityThread.handleBindApplication(ActivityThread.java:4545) at android.app.ActivityThread.access$1500(ActivityThread.java:154) at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1369) at android.os.Handler.dispatchMessage(Handler.java:102) at android.os.Looper.loop(Looper.java:135) at android.app.ActivityThread.main(ActivityThread.java:5275) at java.lang.reflect.Method.invoke(Native Method) at java.lang.reflect.Method.invoke(Method.java:372) at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:909) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:704) Caused by: java.lang.ClassNotFoundException: com.linchaolong.android.app.MyApplication at java.lang.Class.classForName(Native Method) at java.lang.Class.forName(Class.java:306) at java.lang.Class.forName(Class.java:270) at com.android.tools.fd.runtime.BootstrapApplication.createRealApplication(BootstrapApplication.java:209) at com.android.tools.fd.runtime.BootstrapApplication.attachBaseContext(BootstrapApplication.java:239) at android.app.Application.attach(Application.java:185) at android.app.Instrumentation.newApplication(Instrumentation.java:996) at android.app.Instrumentation.newApplication(Instrumentation.java:980) at android.app.LoadedApk.makeApplication(LoadedApk.java:560) at android.app.ActivityThread.handleBindApplication(ActivityThread.java:4545) at android.app.ActivityThread.access$1500(ActivityThread.java:154) at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1369) at android.os.Handler.dispatchMessage(Handler.java:102) at android.os.Looper.loop(Looper.java:135) at android.app.ActivityThread.main(ActivityThread.java:5275) at java.lang.reflect.Method.invoke(Native Method) at java.lang.reflect.Method.invoke(Method.java:372) at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:909) at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:704) Caused by: java.lang.ClassNotFoundException: Didn't find class "com.linchaolong.android.app.MyApplication" on path: DexPathList[[zip file</code></pre> <p>原因是 Android Studio 的 Instant Run 尝试对你的代码执行热交换，导致 Application 类被移除所以出现 ClassNotFoundException。</p> <p>停用 Instant Run， File --> Settings--> Build,Execution,Deployment -->Instant Run ---> 取消勾选 "Enable instant run"</p> <h2><strong>相关文章</strong></h2> <ul> <li><a href="/misc/goto?guid=4959741068082130860" rel="nofollow,noindex">Intellij IDEA使用技巧整理</a></li> <li><a href="/misc/goto?guid=4959741068175074453" rel="nofollow,noindex">Android Studio各种快捷功能及好用的插件</a></li> <li><a href="/misc/goto?guid=4959741068254539157" rel="nofollow,noindex">tools 属性参考文档</a></li> </ul> <p> </p> <p>来自：https://juejin.im/entry/58bfd80ea22b9d00588c3444</p> <p> </p>