从此
📄文章 #️⃣专题 🌐酷站 👨‍💻技术 📺 📱

Android OS系统和应用开发


综合

minSdk 首选 28+; 自用支持MethodHandle的26+;targetSdk 首选 28+。 Android更多开发知识专题
Android各版本统计(英文版数据较新)

Android 14起Java 17 LTS新特性:HexFormat、record 和 多行文本块儿;
Android 14起访问或选取媒体文件时会多出一项“选择照片和视频”(READ_MEDIA_VISUAL_USER_SELECTED权限),避免只能全部允许的风险。
Android 13起后台Toast弹框(前台则正常弹)必须静态和动态申请POST_NOTIFICATIONS权限,故只能换用前台Service?
中国大陆手机不允许安装未备案app应用,可通过断网安装或第三方安装器解决。
Android Studio Koala起支持(新项目 -> Gemini API Starter)Gemini聊天、文生图: https://developer.android.com/studio/preview/gemini-template?hl=zh-cn

Google Play Console 发布PC游戏(上架要求arm64 + x86-64) -> 设置 -> 高级设置 -> 设备规格 -> +添加“Google Play 游戏电脑版”;玩家客户端在设置中启用“Hyper-V Hypervisor”才不会卡顿。
Google Play Games 电脑版开发者模拟器 - PC端上架前测试用(打开即进入Android桌面/返回键为Ctrl+B,Home屏为Ctrl+H/用adb安装apk),右下角图标右键"Validate Game Readiness"。

工具

Android Studio开发IDE官方下载(安装后空间占用10GiB+)

Android Debug Bridge(ADB/调试桥)官方下载

Android Gradle Plugin(AGP)版本列表

JADX - Android apk文件反编译工具(请合法使用)
Android官方apk/aab文件反编译GUI工具和命令行apkanalyzer

Java Keystores (.jks or .keystore):
  说明 - 证书生成的参数相同,不代表生成后的证书,在全世界都是相同的,而是依照证书指纹来决定。

  生成 debug.keystore 命令命令参考/可选参数:-sigalg SHA256withRSA -keysize 2048 / -alias值大小写均可 )
    keytool -genkey -alias AndroidDebugKey -keyalg RSA -dname "CN=Android Debug,O=Android,C=US" -validity 10950 -keypass android -keystore debug.keystore -storepass android

  查看证书命令(输入密钥库口令: android /有效期默认为30年*365日=10950天)
    C:\Progra~1\Java\jdk-22\bin\keytool -list -v -keystore C:\Users\person\.android\debug.keystore

  或gradle查看signingConfigs配置块儿签名信息、证书指纹: ./gradlew signingReport

  为Android程序apk文件签名(默认并存v1至当前SDK支持的所有版本签名,安卓OS校验时忽略不识别的,之后选用版本高者,可主动禁用;首选v4及支持轮替的v3 / --v4-signing-enabled only )
    apksigner sign --ks debug.keystore --v1-signing-enabled false --v2-signing-enabled false app.apk

  查看签名版本
    apksigner verify --verbose app.apk

bundletool官方下载

  aab转apks并部署:参数--connected-device和--adb均为可选
    java -jar E:\bundletool-all-1.15.5.jar build-apks --bundle=D:\projects\NewTileMatching.aab --output=D:\projects\NewTileMatching.aab.apks --connected-device
    java -jar E:\bundletool-all-1.15.5.jar install-apks --apks=D:\projects\NewTileMatching.aab.apks --adb=C:\Users\aw\AppData\Local\Android\Sdk\platform-tools\adb.exe

文章

本站Android产品展示


Android核心服务、系统组件

谷歌三件套

Google Services Framework(com.google.android.gsf)

Google Play Services(com.google.android.gms)

Google Play Store


发布、测试

  Google Play应用市场上架要求 Google Play开发者账号闲置规则
  2024年起创建的Google Play个人账号,新增了上架条件:必须 20 名测试人员连续参与测试 14 天。
  Android反射non-sdk限制分类(unsupported=允许反射) 解除限制:adb shell settings put global hidden_api_policy  1

  IDE:
    通过Logcat查看日志 -  level:error fullchannel

  Android Studio默认提供了两种测试类型package:Instrumented test(插桩测试)和Unit test(单元测试)
    注意 - 可通过Firebase Test Lab控制台(“运行测试”按钮下拉选类型)上传apk或命令行、API等方式执行测试;
      Test Lab控制台插桩测试时(gradle assembleDebugAndroidTest),第一个apk上传含主启动Activity的apk,第二个上传测试apk;否则报:"The uploaded APK does not specify a main launcher activity."。
      Test Lab控制台Robo测试时(gradle assembleDebug),若还未给Release版生成签名,可先上传Debug版本apk版解决无签名报错,同时还应上传在AS上录制的Robo脚本(Tools > Firebase -> Test Lab -> Record Robo Script)。
      Test Lab控制台测试前,确认下真机版本跟待测app是否兼容。

    Instrumented test(插桩测试) - 引入了UI测试库Espresso但未使用;
      测试命令 - [只能Debug] gradle connectedStoreDebugAndroidTest 或 connectedFullDebugAndroidTest、connectedAndroidTest、cAT
          app/build/reports/androidTests/connected/debug/flavors/store/com.wangxiaodong.apps.playphone.ExampleInstrumentedTest.html
        assembleAndroidTest
          app\build\outputs\apk\androidTest\store\debug\app-store-debug-androidTest.apk
      测试时截图 - https://github.com/android/testing-samples/blob/main/ui/espresso/ScreenshotSample/app/src/androidTest/java/com/example/android/testing/espresso/screenshotsample/ScreenshotJavaTest.java

  Google Play测试:开放式测试(暴露页面)、封闭式测试、内部测试(免审核)
    注意 - 交由指定测试人员进行人工测试前,会先执行自动化测试,但也能关闭该前置自动化测试(即回放Robo预录脚本的“发布前测试报告”)。
    内部测试 - xxx

  Android Chrome浏览器日志查看:
    开发者模式 -> 启用 USB调试;
    打开 Android Chrome 浏览器并访问待调试的页面;
    然后打开桌面 Chrome 浏览器并访问 chrome://inspect/#devices
    等待数秒就看到“Redmi K30i 5G”的remote device了,点击 inspect 链接进入“DevTools”。

编程


  四大基本组件:Activity、Service服务、BroadcastReceiver广播接收器、Content Provider内容提供者
  生命周期:
    避免创建Application且启动较早做法 - Application attachBaseContext -> 【ContentProvider onCreate】 -> Application onCreate

  pkg.R类导出前后均可见,包名由applicationId决定;而BuildConfig类则只存在于编译时,导出后所用之处会变为实际值,包名由namespace/package决定;
  启用构建配置常量:BuildConfig.VERSION_NAME; gradle.properties必须配上 - android.defaults.buildfeatures.buildconfig=true
    多变种时不能直接用R.string访问,应反射之:ViewCommon.getStringByResName(getApplicationContext(), "google_app_id");

  布局:
    多页面首选简单的TabLayout(可选划切ViewPager2+FragmentStateAdapter),次选需配置xml项的BottomNavigationView(Tabs区)+NavHostFragment(内容区)
      implementation("androidx.viewpager2:viewpager2:1.0.0")
      
      注意 - Fragment布局为ConstraintLayout时会被遮挡,故ViewPager2必须设为android:layout_height="match_parent"。

      ViewPager2 vp2=findViewById(R.id.vp2); vp2.setAdapter(new VP2Adapter(this)); // 或用RecyclerView.Adapter
      public class VP2Adapter extends FragmentStateAdapter {
        public VP2Adapter(@NonNull FragmentActivity fragmentActivity) { super(fragmentActivity); }
        List list = List.of(VP2Fragment.newInstance(null, null), VP2Fragment.newInstance(null, null));
        @NonNull @Override // 延迟实例化可将List.of(f...)改为在createFragment中new对象。
        public Fragment createFragment(int position) { return list.get(position); }
        @Override public int getItemCount() { return list.size(); }
      }
 
      
      联动ViewPager2和TabLayout:
        TabLayout tl = findViewById(R.id.tabs);
        new TabLayoutMediator(tl, vp2, (tab, position) ->
                tab.setText("Tab " + (position + 1))).attach();
      自定义tab视图:tab.setCustomView(view); 或 tl.getTabAt(0).setCustomView(view);

  最简Fragment:
   public class MiniFragment extends Fragment {
    @Nullable @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        return inflater.inflate(R.layout.fragment_vp2, container, false);
    }
   }

  Android后台线程执行前台UI操作:
// 解决 Can't toast on a thread that has not called Looper.prepare() 28+ Use:getApplicationContext().getMainExecutor().execute(() -> { }); new Handler(Looper.getMainLooper()).post(() -> {//避免用Looper.prepare() Toast.makeText(context, "...", Toast.LENGTH_SHORT).show(); }); View控件: 根View对象(ViewGroup/含标题栏) - activity.this.getWindow().getDecorView() 等同 view.getRootView(); 内容视图(布局文件/不含标题栏) - activity.this.findViewById(android.R.id.content) Toast前台替代 - Snackbar.make(view.getRootView(), "msg", Snackbar.LENGTH_SHORT).show(); FloatingActionButton(FAB/基于ImageView) - 比普通控件多一个交互动画。 通过名字获取resId: @SuppressLint("DiscouragedApi") // 允许用但性能差,为0则无此resId。 getResources().getIdentifier("google_app_id", "string", getPackageName()); 权限: 静态权限 - <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="com.google.android.gms.permission.AD_ID" /> FOREGROUND_SERVICE(前台Service)、RECEIVE_BOOT_COMPLETED 需要用户明确同意的权限 - POST_NOTIFICATIONS(通知) 需要Google Play控制台审批的权限 - USE_FULL_SCREEN_INTENT(闹钟、电话可在Play控制台申请默认启用) 共享存储: 高于maxSdkVersion版本的则废弃此权限:

      <uses-permission
        android:name="android.permission.READ_EXTERNAL_STORAGE"
        android:maxSdkVersion="32" />
      <uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE"
        android:maxSdkVersion="29" />

用以下细化权限项来替代: <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" /> 以及 READ_MEDIA_VIDEO READ_MEDIA_AUDIO Android 11起采用了包可见性机制,默认可见应用有:adb shell dumpsys package queries forceQueryable:标签下的apk 表示 可见所有已安装的apk queries via package name: 标签表示只有配置了包名 才对该app可见 queries via intent: 标签表示只有配置了intent 才对该app可见 queryable via uses-library: queryable via interaction: 应用包安装: 显式安装权限 - android.permission.REQUEST_INSTALL_PACKAGES 静默安装权限(只能用于系统应用) - android.permission.INSTALL_PACKAGES WebView载入目录索引页会报JavaScript脚本xxx未定义而页面空白 单文件+多文件分享: intent.getParcelableExtra(Intent.EXTRA_STREAM); intent.getParcelableArrayListExtra(Intent.EXTRA_STREAM); 解决 AlertDialog+getApplicationContext() 报错 Unable to add window -- token null is not valid; 例外:Toast可用任何上下文及getApplicationContext() new AlertDialog.Builder(view.getContext()).setMessage("msg").create().show();// or MainActivity.this 解决横竖屏切换阻止构建 android:screenOrientation="portrait" tools:ignore="LockedOrientationActivity" tools:replace="android:screenOrientation" Gradle构建: android { buildFeatures { buildConfig = true } // 启用后才会生成BuildConfig.DEBUG defaultConfig { // x86_64、x86仅用于模拟器调试或ChromeOS系统 ndk.abiFilters 'arm64-v8a', 'x86_64','x86' // 'armeabi-v7a','arm64-v8a','x86','x86_64' } buildTypes { debug { ndk.abiFilters 'arm64-v8a', 'x86_64' } release { //noinspection ChromeOsAbiSupport ndk.abiFilters 'arm64-v8a' } // 只保留需要支持的系统so库 // 本地依赖库无名为other的buildType时进行降级 other { matchingFallbacks = ['debug', 'qa', 'release'] } } } Android插件Gradle国内仓库: [铁定被墙] google() 大陆镜像 https://maven.aliyun.com/repository/google 包含 com.android.application 等插件。 gradlePluginPortal() 即 https://plugins.gradle.org/m2/ 大陆镜像 https://maven.aliyun.com/repository/gradle-plugin 包含 gradle 插件(除 Android 外)。 gradlePluginPortal()改url用法 - GRADLE_OPTS环境变量值添加 -Dorg.gradle.internal.plugins.portal.url.override=https://maven.aliyun.com/repository/gradle-plugin mavenCentral() 大陆镜像 https://maven.aliyun.com/repository/central 开机解锁前应用执行 - android:directBootAware="true"只是标记下,并不会开机启动,还应标记下注册了LOCKED_BOOT_COMPLETED的receiver。 开机解锁后应用执行 - BOOT_COMPLETED 关闭代码分析提示: android { lint { abortOnError = false checkReleaseBuilds = false } // ... } 解决 Duplicate class kotlin... - implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.20"))


其他

  android.os.NetworkOnMainThreadException解决:new Thread(Runnable).start();
  Only the original thread that created a view hierarchy can touch its views.解决:handler.post(Runnable);