Flutter 開發筆記 - 排除 Could not open settings generic class cache for settings file @ macOS 13.2.1, openjdk 19.0.2, Android Studio Electric Eel | 2022.1.1 Patch 2

最近工作上關係，來回顧一下 Flutter app 的開發，預計寫一款非常簡單的 App 試試水溫。結果在 macOS 13.2.1, openjdk 19.0.2, Android Studio Electric Eel | 2022.1.1 Patch 2 環境，預設弄個專案出來卻不能編譯：

Launching lib/main.dart on sdk gphone64 arm64 in debug mode...

Running Gradle task 'assembleDebug'...

FAILURE: Build failed with an exception.

* What went wrong:

Could not open settings generic class cache for settings file '/Users/UserID/AndroidStudio/usb_displayport_helper/android/settings.gradle' (/Users/UserID/.gradle/caches/7.5/scripts/XXXXXX).

> BUG! exception in phase 'semantic analysis' in source unit '_BuildScript_' Unsupported class file major version 63

* Try:

> Run with --stacktrace option to get the stack trace.

> Run with --info or --debug option to get more log output.

> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 24s

Exception: Gradle task assembleDebug failed with exit code 1

研究了一下，主因是 JDK 與 Gradle 版本問題，需要多做一些事就能排除了。記錄一下。

此時環境：

% java --version

openjdk 19.0.2 2023-01-17

OpenJDK Runtime Environment (build 19.0.2+7-44)

OpenJDK 64-Bit Server VM (build 19.0.2+7-44, mixed mode, sharing)

這時，在既有專案的左邊上方的 Project 小視窗，挑選 android 目錄，點選右鍵 -> Flutter -> Open Android module in Android Studio -> New Window ，在新的 Android Studio 還沒按 Build 就看到訊息：

Unsupported Java. 

Your build is currently configured to use Java 19.0.2 and Gradle 7.5.

Possible solution:

 - Open Gradle wrapper settings, change `distributionUrl` property to use compatible Gradle version and reload the project

這時就來更換預設的環境： File -> Project Structure -> Project

- Android Gradle Plugin Version: 7.4.2

- Gradle Version: 7.6.1

按下 OK 就會開始抓資料，最後也順利編譯後在模擬器上跑了。

Flutter 開發文件之 iOS 與 Android 實作筆記 - 使用 Firebase 回報 App 使用人數

先說一下，有出類似文件教人怎樣使用 Firebase - Admob 部分，在此僅流水帳紀錄引用 firebase 的用法，體驗一下透過 Flutter 同時開發 ios 和 android app 時，並且使用額外函式庫的過程。

原理：

1. 使用 Android Studio + Flutter plugin 來建立 Flutter 專案
- 在此 package name 使用 org.changyy.study.flutter
- 自動產生 android Package Name = org.changyy.study.flutter_app
- 自動產生 iOS Bundle ID = org.changyy.study.flutterApp
- 假定專案位於 ~/AndroidStudioProjects/flutter_app

2. 建立 Firebase 專案
- 在此使用 org-changyy-study-flutter 作為 firebase project name

3. iOS app
- 使用 Xcode 置入 firebase 的設定檔案 GoogleService-Info.list
- 用指令打開專案 % open ~/AndroidStudioProjects/flutter_app/ios/Runner.xcworkspace/
- 使用 CocoaPods 添加 Firebase 函式庫
- 在 AppDelegate.swift 置入 Firebase 啟動程式碼

4. Android app
- 依照 Firebase 專案建置過程安置 google-service.json 檔案
- 在 <專案>/build.gradle 設置相依套件 com.google.gms:google-service:4.3.4
- 在 <專案>/app/build.gradle 添加 plugin 和引入 com.google.firebase:firebase-analytics

5. 回到 Flutter 專案，分別叫出 iOS simulator 跟 Android emulator 運行

若沒意外，就可以同時在這兩個模擬器上跑出來，並且在 Firebase 專案後臺，看到兩個使用者：

Android 開發筆記 - 使用 Android Studio 和 ViewPagerIndicator

上網亂找一下，大家好像還滿推四年前就沒再更新的 ViewPagerIndicator ，且很猛的共有超過 7k 的人關注，接近 4k 的人 fork 了此專案：https://github.com/JakeWharton/ViewPagerIndicator

總之，為了之後的維護管理，還是老樣子繼續練 Android Studio！添加額外第三方時，因為此 project 已經很久沒更新了，所以要採用下述安裝法：

build.gradle (Project):

allprojects {
repositories {
maven { url "http://dl.bintray.com/populov/maven" }
mavenCentral()
}
}

build.gradle (app)：

dependencies {
// https://github.com/JakeWharton/ViewPagerIndicator/releases , 2012/09/13: 2.4.1
compile 'com.viewpagerindicator:library:2.4.1@aar'
// 預設的 Android Studio 環境應該不會使用下述，若仍有問題再開啟吧
//compile 'com.android.support:support-v4:23.2.0'
}

接著在 content_main.xml (若其他 layout) 添加 com.viewpagerindicator.* 系列程式碼，並且要配置 android.support.v4.view.ViewPager 才行：

    <com.viewpagerindicator.TabPageIndicator
        android:id="@+id/indicator"
        android:layout_height="wrap_content"
        android:layout_width="fill_parent"
        />
    <android.support.v4.view.ViewPager
        android:id="@+id/pager"
        android:layout_width="fill_parent"
        android:layout_height="0dp"
        android:layout_weight="1"
        />

最後在 Activity 初始化：

protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        ViewPager mViewPager = (ViewPager)findViewById(R.id.pager);
        mViewPager.setAdapter(new PagerAdapter() {
            @Override
            public int getCount() {
                return 0;
            }

            @Override
            public boolean isViewFromObject(View view, Object object) {
                return false;
            }
        });

        TabPageIndicator mTabPageIndicator = (TabPageIndicator)findViewById(R.id.indicator);
        mTabPageIndicator.setViewPager(mViewPager);
}

以上是先滿足編譯跟執行需求，至於 TabPageIndicator 真的要怎樣用就不在此贅述了。

Android 開發筆記 - 在 Android Studio 環境上，使用 Google Analytics SDK / Admob SDK

使用 Android Studio 1.5.1 版，原先參考 Google 官方文件，結果一直爆問題 :P 其中 Google Analytics SDK 跟 Admob SDK 都會需要 Google Service 的環境，而碰到 Google Service 的引入不斷出錯，以下單純記錄修正流程。

參考 https://developers.google.com/analytics/devguides/collection/android/v4/ 和 https://developers.google.com/admob/android/app 資訊，更新 AndroidManifest.xml 位置，添加：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

接著在 build.gradle (Project) 添加:

classpath 'com.google.gms:google-services:2.0.0-alpha6'

在 build.gradle (app) 添加：

dependencies {
//...
compile 'com.google.android.gms:play-services-analytics:8.4.0'
}
apply plugin: 'com.google.gms.google-services'

結果一直出錯：Gradle sync failed: Unable to load class 'com.android.sdklib.repository.FullRevision'. 這種很 general 的訊息。

甚至跑去看看 googlesample 檔案，如：

• google-services/android/analytics
• google-services/android/admob

分別查看：build.gradle、app/build.gradle 和 gradle/wrapper/gradle-wrapper.properties 三個檔案。

改採用：

dependencies {
        //classpath 'com.android.tools.build:gradle:1.5.0'
        classpath 'com.android.tools.build:gradle-experimental:0.4.0'

        classpath 'com.android.tools.build:gradle:2.0.0-beta5'
        classpath 'com.google.gms:google-services:2.0.0-beta5'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
}

仍是一樣的現象，最後靠直覺，嘗試亂改 classpath 'com.google.gms:google-services:1.0.0+' 後，會看到錯誤訊息引導說，可以查看 metadata 得知有哪些版本可用：

https://jcenter.bintray.com/com/google/gms/google-services/maven-metadata.xml

就這樣，直接挑沒有 beta/alpha 字眼:

dependencies {
        classpath 'com.android.tools.build:gradle:1.5.0'
        classpath 'com.android.tools.build:gradle-experimental:0.4.0'
        classpath 'com.google.gms:google-services:1.5.0'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
}

以及 gradle/wrapper/gradle-wrapper.properties 使用：

#distributionUrl=https\://services.gradle.org/distributions/gradle-2.8-all.zip distributionUrl=https\://services.gradle.org/distributions/gradle-2.11-all.zip

如此一來，終於解掉編譯問題。接續就可以參考 Google Analytics SDK/Admob SDK 的文件，例如產生 google-services.json 以及 AnalyticsApplication extends Application 等用法等。

最後，我自己的用法：

AndroidManifest.xml:
...
<application
        android:name=".MyApplication"
        ...
>
...
</application>

MyApplication.java:
import android.app.Application;
import com.google.android.gms.analytics.GoogleAnalytics;
import com.google.android.gms.analytics.Tracker;
public class MyApplication extends Application {
        private Tracker mTracker;
        synchronized public Tracker getDefaultTracker() {
               if (mTracker == null) {
                      GoogleAnalytics analytics = GoogleAnalytics.getInstance(this);
                      // To enable debug logging use: adb shell setprop log.tag.GAv4 DEBUG
                      //mTracker = analytics.newTracker(R.xml.global_tracker);
                      mTracker = analytics.newTracker("UA-XXXXXXX-XX");
               }
               return mTracker;
        }
}

build.gradle (app):
dependencies {
        compile fileTree(dir: 'libs', include: ['*.jar'])
        testCompile 'junit:junit:4.12'

        compile 'com.android.support:appcompat-v7:23.2.0'
        compile 'com.android.support:design:23.2.0'

        // Google Analytics & Admob
        compile 'com.google.android.gms:play-services:8.4.0'
        compile 'com.google.android.gms:play-services-ads:8.4.0'
        compile 'com.google.android.gms:play-services-analytics:8.4.0'
}


build.gradle (Project):
dependencies {
        classpath 'com.android.tools.build:gradle:1.5.0'
        classpath 'com.android.tools.build:gradle-experimental:0.4.0'

        classpath 'com.google.gms:google-services:1.5.0'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
}

MainActivity.java:
protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        MyApplication application = (MyApplication) getApplication();
        Tracker mTracker = application.getDefaultTracker();
        mTracker.setScreenName("main");
        mTracker.send(new HitBuilders.ScreenViewBuilder().build());
        //...
}

Android 開發筆記 - 在 Android Studio 環境上使用 NDK (JNI) @ Mac OS X 10.11.3

上一次把玩已經是 2011 年的事了 :P 這次再練一下。首先，我已經安裝好 Android Studio 1.5.1 版本。接著先下載 Android NDK：

Android Studio -> SDK Manager -> Android SDK -> SDK Tools -> 勾選 Android NDK (1.0.0) -> 進行下載。下載完後可以看到 Project -> local.properties 已經自動埋好 ndk.dir=/path/ndk 資訊啦，若一開始 local.properties 有 ndk.dir 資料，或許會造成問題。

接著，依照 http://tools.android.com/tech-docs/new-build-system/gradle-experimental#TOC-Ndk-Integration 簡介在 build.gradle (Module: app) 添加這一段：

apply plugin: 'com.android.model.application'

model {
    android {
        compileSdkVersion 23
        buildToolsVersion "23.0.2"
        ndk {
            moduleName "native"
        }
    }
}

Sync Now 後，立馬得到： Error:(23, 0) Plugin with id 'com.android.model.application' not found.

找了很久，最後參考 googlesample 範例（隨便挑一個，例如：https://github.com/googlesamples/android-ndk/blob/master/MoreTeapots/app/build.gradle 和 https://github.com/googlesamples/android-ndk/blob/master/MoreTeapots/build.gradle），做了很多動作：

先到 build.gradle (Project) 更新：

dependencies {
        //classpath 'com.android.tools.build:gradle:1.5.0'
        classpath 'com.android.tools.build:gradle-experimental:0.4.0'
}

再把 build.gradle (Module: app) 整段更新：

/*
apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.2"

    defaultConfig {
        applicationId "YourAppPackageName"
        minSdkVersion 15
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}
// */

apply plugin: 'com.android.model.application'

model {
    android {
        compileSdkVersion = 23
        buildToolsVersion = "23.0.2"

        defaultConfig.with {
            applicationId = "YourAppPackageName"
            minSdkVersion.apiLevel = 15
            targetSdkVersion.apiLevel = 23
            versionCode = 1
            versionName = "1.0"
        }
    }
    android.buildTypes {
        release {
            minifyEnabled = false
            proguardFiles.add(file('proguard-rules.pro'))
        }
    }
    android.ndk {
        moduleName = "native"
    }
}

按下 Sync Now 後，終於沒問題了，離 JNI 又更進一步了！

再點擊 app 目錄 => 按右鍵 New -> Folder -> JNI Folder ，再到 jni 目錄添加一下檔案 -> New -> C/C++ Source file -> 此例用 main.cpp/main.h 為例。

如此一來，只要 Build APK 後，跑去 unzip app-debug-unaligned.apk 後，可以看到以下的目錄結構：

$ tree lib/
lib/
├── arm64-v8a
│   ├── gdb.setup
│   ├── gdbserver
│   └── libnative.so
├── armeabi
│   ├── gdb.setup
│   ├── gdbserver
│   └── libnative.so
├── armeabi-v7a
│   ├── gdb.setup
│   ├── gdbserver
│   └── libnative.so
├── mips
│   ├── gdb.setup
│   ├── gdbserver
│   └── libnative.so
├── mips64
│   ├── gdb.setup
│   ├── gdbserver
│   └── libnative.so
├── x86
│   ├── gdb.setup
│   ├── gdbserver
│   └── libnative.so
└── x86_64
    ├── gdb.setup
    ├── gdbserver
    └── libnative.so

其中 libnative.so 則是跟 android.ndk 裡定義的名字。