近日將Android studio升級到3.0.1，Gradle升級到了4.1，升級好之後發現遇到了不少問題，具體如下：

一、APK打包批量修改APK名稱匯出功能報錯

Cannot set the value of read-only property 'outputFile' for ApkVariantOutputImpl_Decorated

output.outputFile變成了只讀屬性，不能再往裡面寫東西了，以下是3.0之前的配置：

applicationVariants.all { variant ->    //批量修改Apk名字    variant.outputs.each { output ->

        def outputFile = output.outputFile        if (outputFile != null && outputFile.name.endsWith('.apk') && 'release'.equals(variant.buildType.name)) {

def fileName = "release_v${defaultConfig.versionName}_${realTime()}.apk"
output.outputFile = new File(releaseFile.parent, fileName)
 

        }    }}

現在不能為修改賦值了，

applicationVariants.all { variant ->
    variant.outputs.all { output ->
        def releaseFile = output.outputFile;
        if (releaseFile.name.endsWith('release.apk')) {
             //獲取簽名的名字 variant.signingConfig.name
            /*def fileName = "release_v${defaultConfig.versionName}_${realTime()}.apk"
 
            output.outputFile = new File(releaseFile.parent, fileName)*/
outputFileName = "release_v${defaultConfig.versionName}_${realTime()}.apk"
}
    }
}

二、Android Studio 3.0 butterknife:7.0.1配置的問題

Error:Execution failed for task ‘:app:javaPreCompileDebug'.Annotation processors must be explicitly declared now. The following dependencies on the compile classpath are found to contain annotation processor. Please add them to the annotationProcessor configuration. - butterknife-7.0.1.jar (com.jakewharton:butterknife:7.0.1)Alternatively, set android.defaultConfig.javaCompileOptions.annotationProcessorOptions.includeCompileClasspath = true to continue with previous behavior. Note that this option is deprecated and will be removed in the future. 解決辦法：在專案的project 的build.gredle 檔案中的dependencies標籤下刪除。classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'；在module的build.gredle 檔案中刪除apply plugin: 'android-apt'；在module的build.gredle 檔案中的dependencies標籤中刪除apt 'com.jakewharton:butterknife-compiler:8.4.0'，加上 annotationProcessor ‘com.jakewharton:butterknife:7.0.1'即可解決。三、、、、Android Studio 3.0 新功能解析和舊專案適配Android Studio升級後可能會遇到一些問題，需要對舊的工程做一些配置上的調整而已。下面文章就來介紹新版開發工具給我們帶來哪些實用的改變，並以實際操作經驗告訴大家，舊工程的配置需要如何做相容修改。

3.0 帶來的改變

Kotlin Support

在 Android Studio 3.0 之前，使用 Kotlin 語言開發安卓應用，需要額外配置 Kotlin 外掛。而新版本內建預設支援 Kotlin 語言，來減少我們在配置上的工作。

選擇工具欄 Code ——》 Convert Java File To Kotlin File，或者使用快捷鍵的形式，你可以一鍵實現 Java 檔案到 Kotlin 檔案的轉換。

備註：關於快捷鍵的使用，你可以使用 Command + Shift + A 這組快捷鍵開啟 Find Action視窗，輸入關鍵字尋找對應功能及其快捷鍵，效果就像上面 Gif 圖展示的這樣。

Java 8 Support

3.0 對 Java 8 語言特性的預設支援使你不用在 build.gradle 配置檔案中新增 jackOptions 一項。如果你有使用到的話，記得刪除：

android {
    ...
    defaultConfig {
        ...
        // Remove this block.
        jackOptions {
            enabled true
            ...
        }
    }
}

選擇工具欄 File ——》Project Structure，修改 Source Compatibility 和 Target Compatibility 選項到 1.8 即可使我們的專案支援 Java 8 語言特性。

Android Profiler

過去我們使用的 Android Monitor 工具從 3.0 版本開始被 Android Profiler 替代掉了。如圖，run 按鈕一欄多了一個 Android Profiler 按鈕：

Android Profiler 提供有 CPU、Memory 和 Network 三大除錯分析利器，實時跟蹤 Apk 的執行狀態，可以幫助我們視覺化地做一些效能調優工作。

這三個工具在開發階段非常實用，比如 CPU Profiler 能夠分析應用中的執行緒使用情況，Memory Profiler 能夠檢測出記憶體洩漏，Network Profiler 能夠攔截網路請求實現抓包功能等。這裡列舉一些使用圖片，簡單預覽一下這三大工具的風采：

有關這幾個工具的詳細使用細節，可以參考官方的介紹：

• CPU Profiler guide

• Memory Profiler guide

• Network Profiler guide

Device File Explorer

這個功能厲害了。新版開發工具帶來的資源管理器允許我們訪問連線裝置的檔案系統，實現 PC 端到手機或模擬器端的便捷檔案傳輸。有了這個工具，從此就可以告別之前使用的「檔案傳輸助手」等第三方工具啦。

Adaptive Icons wizard

選擇 File -> New -> Image Asset，利用 Android Studio 提供的工具建立圖片資源一直以來也是開發利器之一。現在，這個工具開始支援vector drawables 格式，並且能夠建立用於適配 Android 8.0 系統上各種形狀的桌面圖示。

URL intent-filter validator

這個功能也蠻貼心的。Manifest 清單檔案開始支援一個特殊的標籤，用於測試給定的 Url 字串是否符合 intent-filter 標籤內容所定義的規則。舉個例子：

如圖，這裡使用 data 標籤定義一個 Url 規則，並使用 tools:validation 標籤驗證一個錯誤的測試 Url 地址，檢測器能夠自動識別並給出錯誤提示。這個例子很簡單，肉眼一眼就能看出錯誤。那如果是比較複雜的規則呢，可能就不那麼容易看得出來。這個時候，這個工具就可以派上用場啦。

APK Analyzer

3.0 版本對 APK Analyzer 的功能做了進一步強化。主要在於：對於使用 ProGuard 混淆過的 APK 檔案，我們能夠上傳 mapping.txt 檔案進行程式碼還原；Dex 檔案提供顯示各個包目錄的大小；等等。

其他功能

除了上面介紹的這些變化，還有一些其他大大小小的變更。比如 Layout Inspector 和 Layout Editor 工具在 UI 上有所調整，比如 App Links Assistant 和 Firebase App Indexing Assistant 的強化使用，這些留著大家自己去探索發現吧。也可以訪問 Android Studio Release Notes官網，瞭解 3.0 版本的更多釋出細節。

舊專案的適配

Android Studio 3.0 釋出的同時，Android Plugin for Gradle 3.0.0 也同時釋出。編譯速度整體都得到了大幅提升。升級完 Android Studio 之後，舊的工程需要做出部分改變，才能通過 Gradle 的編譯。這裡根據我的一個實際專案，介紹一下需要改變的內容。當然，也許你的專案用不上這些，也可能不止這些。

distributionUrl

Plugin 3.0.0+ 需要配置 Gradle 的最小版本是 4.1，我們可以通過 File -> Project Structure -> Project 的方式設定 Android Plugin 的版本，或者修改 gradle.properties 檔案的內容，新增 distributionUrl 屬性：

distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip

Google's Maven repository

新版 Android Studio 工具預設使用 Google’s Maven Repository 用於下載依賴 Android Support Library，替代了 Android SDK Manager 的本地依賴方式。所以，需要在工程根目錄下的 build.gradle 檔案中新增 google() 一行程式碼：

allprojects {
    repositories {
        google()
    }
}

buildToolsVersion

Android Plugin For Gradle 3.0.0 預設自動新增外掛所需要用到的最小版本的編譯工具。所以，我們不需要再手動在 build.gradle 新增一行 buildToolsVersion 屬性的程式碼。對於舊的專案，可以去掉這行配置，比如：

android {
    compileSdkVersion 26
    // remote buildToolsVersion
    buildToolsVersion "25.0.2"
    ...
}

each() 和 outputFile()

Plugin 3.0.0 版本移除了一些用於編譯配置的 API，其中比較常見的就是 each() 和 outputFile()，兩個常用於修改輸出 Apk 檔名和路徑的方法。

在之前的文章 Android Gradle 常用使用場景實現方式的總結中有提到，自定義輸出 APK 檔名可以這樣做：

android {
    android.applicationVariants.all { variant ->
        variant.outputs.each { output ->
            output.outputFile = new File(output.outputFile.parent, rootProject.getName()
                    + "-" + buildType.name
                    + "-" + releaseTime()
                    + "-v" + defaultConfig.versionName
                    + "-" + defaultConfig.versionCode
                    + ".apk");
        }
    }
}

但是使用 Plugin 3.0.0 時就會出現編譯報錯，我們需要修改 each() 和 outputFile() 方法為 all() 和 outputFileName，比如：

android {
    android.applicationVariants.all { variant ->
        variant.outputs.all { 
            outputFileName = rootProject.getName()
                    + "-" + buildType.name
                    + "-" + releaseTime()
                    + "-v" + defaultConfig.versionName
                    + "-" + defaultConfig.versionCode
                    + ".apk";
        }
    }
}

對於舊的工程，基本上便是這些配置上的適配修改。如果你還遇到了別的問題，別緊張，按照編譯錯誤提示一步步操作，也能成功通過編譯。總體來說，這次 Android Studio 3.0 和 Plugin For Gradle 3.0.0 的釋出還是非常值得升級嘗試的。