Android开发手册

Android Studio 的使用

生成APK/ABB文件

生成APK文件: Build -> Build Bundles/APK(s) -> Build APK(s)

谷歌官方建议他们自己管理签名key(Let Google manage and protect your app signing key (recommended))，这时候我们只需要自己生成一个upload key即可，在上传到google后google会进行签名

本地生成upload key，这个upload key可以直接放在app文件夹下

1	keytool -genkeypair -v -keystore my-upload-key.keystore -alias upload-key -keyalg RSA -keysize 2048 -validity 10000

修改build.gradle

android {
    ...
    signingConfigs {
        release {
            storeFile file("path/to/my-upload-key.keystore")
            storePassword "your-keystore-password"
            keyAlias "upload-key"
            keyPassword "your-key-password"
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
        }
    }
}

然后选择对应的Build Variant(需要选择release因为上面是配置的release)，然后点击菜单Build -> Build App Bundle(s) / APK (s) -> Build Bundle(s)
然后就能上传了

自己生成能上传到google playstore的签名了的bundle文件(.abb格式)

Build -> Generate Signed Bundle/APK，生成的时候记得勾选Export encrypted key for enrolling published apps in Google Play App Signing(导出的key的格式是pepk)
如果是第一次上传，可以点击Create new生成一个新的keystore文件(一般会以.keystore或者.jks结尾)
一个keystore可能包含多个alias的key，可以多次点击Create new来生成即可
如果之前没有上传过google play console，那么在console里面直接新建一个release即可，不用先上传key这些
如果之前已经上传了upload key certificate到google play console里面，那么必须用之前的来生成才行，否则上传会提示SHA-1指纹不一致。可以在后台查看Setup -> App Integrity -> Upload key certificate看是否有了，注意这里的Download certificate只是下载公钥，没啥用的。

如果已经有上传证书并且丢失了的话，只能联系google重新生成一个了(注意是Upload key certificate，而不是App signing key certificate)，在这里提交或者页面的contact our support team，下面有一些问题

Is your app enrolled in Play App Signing by Google Play? 选择Yes，然后选择I have an upload key-related issue，然后选择I lost my upload key，选这个。会提示你生成一个新的.pem格式的文件，并且会直接给你生成的命令

1
2

keytool -genkeypair -alias upload -keyalg RSA -keysize 2048 -validity 9125 -keystore keystore.jks # 这条命令其实就是在Android studio里面Create new的功能
keytool -export -rfc -alias upload -file upload_certificate.pem -keystore keystore.jks	# 会生成PEM文件的

~~Is your app enrolled in Play App Signing by Google Play? 选择No，然后选择I lost my upload key，不要选这个，google说它不能重置，你必须创建新的app~~

获取keystore的sha-1指纹: keytool -list -v -keystore {keystore_name} -alias {alias_name}

物理设备镜像到电脑

Settings -> Tools -> Device mirroring -> Enable mirroring of physical Android devices

模拟器里面实现震动

目前能找到能行的方法只有在模拟器设置里面选择Virtual sensors -> Move，然后拖动X、Y、Z三个轴移动，不能太快也不能太慢

模拟器里面使用代理

1 2	# 执行下面命令然后重启模拟器即可 adb shell settings put global http_proxy $(ipconfig getifaddr en0):7890

支持同时构建不同的APP

常用于同时生成测试和生产环境的APP

在build.gradle (:app)中添加如下配置:

// 通过构建hook自动切换.env文件
applicationVariants.all { variant ->
        variant.preBuild.doFirst {
            def flavorName = variant.flavorName
            def envFileName = ".env"

            def flutterRootDir = rootProject.projectDir.parent

            if (flavorName == "app1") {
                envFileName = "$flutterRootDir/env/app1.env"
            } else if (flavorName == "app2") {
                envFileName = "$flutterRootDir/env/app2.env"
            }

            def envFile = new File(envFileName)
            def destinationFile = new File("$flutterRootDir/.env")

            if (envFile.exists()) {
                println "Copying ${envFile.toPath()} to ${destinationFile.toPath()}"
                Files.copy(envFile.toPath(), destinationFile.toPath(), StandardCopyOption.REPLACE_EXISTING)
            } else {
                println "Error: ${envFileName} does not exist."
                throw new GradleException("Missing environment file: ${envFileName}. Build terminated.")
            }
        }
    }

    productFlavors {
        app1 {
            dimension "app"
            applicationId "com.example.app1"
            resValue "string", "app_name", "App 1"
            buildConfigField "String", "ENV_FILE", "\"app1.env\""
        }
        app2 {
            dimension "app"
            applicationId "com.example.app2"
            resValue "string", "app_name", "App 2"
            buildConfigField "String", "ENV_FILE", "\"app2.env\""
        }
    }

Google Play Console的使用

即使google play console审核通过了，且也被邀请加入测试了，也要等很久才能在app store里面搜索得到并且下载，可以直接搜索的
在Activity log中可以查看最近的操作日志
审核被拒: Please provide login credentials: 需要在Policy -> App content -> App access -> Manage 中添加Login Credentials

Testing的区别

如果有IAP内购，那么无论哪一种testing，都不会实际收费

Open testing

允许任何人测试，对任何用户开放，用户可以通过Google Play Store搜索并下载测试版应用
通常用于大规模的beta测试，尤其是希望吸引大量用户并测试应用的稳定性

Closed testing

仅限受邀的测试人员或特定人群参与测试
需要通过链接邀请，链接可以是Google Play应用的链接或者web的链接

Internal testing

主要用于开发团队内部的早期测试，最多10人
提供快速的部署，可以在几分钟内推送应用到测试人员，用于开发过程中的平凡内部测试和调试

Android开发常见需求

In-App Purchase，app内购

要测试app内购，至少需要上传一个build到Google Play的closed testing(in review状态，几分钟就能变成active然后就能测试了，否则会报错The item you were attempting to purchase could not be found.)，且该build不能是debug key签名。还需要创建test users，这些用户才能支付成功，并且还得把该用户添加到License testing(All apps -> Settings -> License testing), License response设置为RESPOND_NORMALLY

Activity生命周期

**onStart()**：可以被用户看到的时候调用的方法
**onRestart()**：从第二个返回第一个，因为第一个没被销毁
**onResume()**：可以获得用户焦点的时候调用
**onPause()**：从一个Activity换向另一个Activity时第一个会调用这个
**onStop()**：当调完第二个时，第一个就调用这个，该Activity处于不可见时，而如果没有全部遮挡起来就不会调用第一个的onStop()方法了
**onDestroy()**：如果点击返回，可能会调用这个，把第二个摧毁了

打印日志

Log.v(String tag, String msg);  //verbose类型日志，颜色为黑色
Log.d(String tag, String msg);  //debug日志，颜色为蓝色
Log.i(String tag, String msg);  //information日志，颜色为绿色
Log.w(String tag, String msg); //warn告警日志，颜色为橙色
Log.e(String tag, String msg); //error错误日志，颜色肯定为红色

String deviceId = Settings.Secure.getString(getContentResolver(), Settings.Secure.ANDROID_ID);	// 获取设备的deviceid

Toast提示框展示日志

import android.widget.Toast;
Toast.makeText(this,"显示内容", Toast.LENGTH_SHORT).show();

// 如果报错Can't toast on a thread that has not called Looper.prepare()，可以这样包装一下
Looper.prepare(); // 准备Looper
Toast.makeText(getApplicationContext(), "Toast message", Toast.LENGTH_SHORT).show();
Looper.loop(); // 启动Looper循环

时间处理

import java.text.SimpleDateFormat;    
SimpleDateFOrmat formatter = new SimpleDateFormat("yyyy年MM月日 HH:mm:ss");
Date curDate = new Date(System.currentTimeMillis()); // 获取当前时间
String str = formatter.formate(curDate);

地理位置

public Location getLocation() {
LocationManager locManger = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
Location loc = locManger.getLastKnownLocation(LocationManager.GPS_PROVIDER);
if (loc == null) \{
    loc = locManger.getLastKnownLocation(LocationManager.NETWORK_PROVIDER);
}
return loc;

TroubleShooting

构建成功，但是运行按钮仍然是灰色: 没有项目的运行配置Run->edit configurations中选择配置module
configurations中没有module可以配置: 选择File->Sync Project with Gradle Fiels，然后重新构建，选择
gradle build running一直卡住: 网上有很多的原因，但是我的原因是代理设置错误(我并不知道什么时候设置过代理了)，在mac上，vim ~/.gradle/gradle.properties修改代理配置即可
org.gradle.api.UncheckedIOException: Failed to capture snapshot of input: 在Settings->Build, Execution, Deployment->Gradle->Android Studio勾选Enable embedded Maven repository
Field to find ‘JAVA_HOME’ environment variable. Try setting it manully: 需要下载对应的jdk，这个网站下载的jdk非常好安装且非常好卸载，直接下载dmg格式的即可，且有直接的apple m1/silicon版本
Duplicate class问题: 如果错误中是googleservice的问题，可以尝试更新*-build.gradle中的google-service版本到最新的classpath 'com.google.gms:google-services:4.3.10'，android studio会提示你升级到最新的
Could not resolve all dependencies for configuration ‘:app:debugRuntimeClasspath’. 或者 No such property: logger for class: org.gradle.initialization.DefaultProjectDescriptor: 可能是ide没有找到node环境，尝试从命令行启动: open -a /Applications/Android\ Studio.app
**Failed to find platform sdk with path: platforms;android-31或者dependency’s AAR metadata (META-INF/com/android/build/gradle/aar-metadata.properties)**需要下载compileSdkVersion中指定的sdk版本
Android Studio的sdk manager没有显示未下载的sdk: 重启android studio试试
Failed to load WebView provider: No WebView installed: 我这边把模拟器的系统升级到android 10就可以了
cannot find symbol android.suppport.v4.app.ActivityCompat：直接替换即可，将import android.support.v4.app.ActivityCompat替换为import androidx.core.app.ActivityCompat即可，这种到androidx的替换，出现一个替换一个就行，没其他问题，我遇到的还有:
1
android.support.v4.app.NotificationCompat -> import androidx.core.app.NotificationCompat;
**MacOs安装指定版本的jdk: ** https://www.azul.com/downloads/?package=jdk
模拟器无法访问网络：可以尝试在AVD的管理面板上选择Cold Boot Now试试

adb command not found: 如果安装了Android Studio可以直接这样:

1 2	export PATH=~/Library/Android/sdk/tools:$PATH export PATH=~/Library/Android/sdk/platform-tools:$PATH

React Native build的APK居然还是需要metro在运行：直接build签名的release的apk

error: package com.android.annotations does not exist:

npm install --save-dev jetifier
npx jetify

# 最后在package.json的scripts中添加
"postinstall": "npx jetify"

Type ‘GoogleServicesTask’ field ‘intermediateDir’ without corresponding getter has been annotated with @OutputDirectory: 需要更新com.google.gms:google-services的版本，在Android Studio中打开build.gradle，修改如下代码:
1
2
3
dependencies {
classpath 'com.google.gms:google-services:4.3.10' // 在修改版本的时候编辑器会自动提示你最新的版本号的
}
Gradle sync failed: Syncfailed: reason unknown: 尝试在SDK Manager中把29到33的SDK都安装上
获取BSSID总是返回02:00:00:00:00:00: 这是因为高版本的android限制了的，就是无解

class butterknife.compiler.ButterKnifeProcessor$RScanner: 可以尝试在gradle.properties中添加参数

org.gradle.jvmargs=-Xmx2048M -Dkotlin.daemon.jvm.options\="-Xmx2048M" \
--add-exports=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED \
--add-exports=jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED \
--add-exports=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED

扩展阅读

仿B站

豪翔天下