前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Android 12 适配攻略

Android 12 适配攻略

作者头像
八归少年
发布2022-09-28 14:42:53
3.1K0
发布2022-09-28 14:42:53
举报
文章被收录于专栏:program

接下来进入今天的主题👉 Android 12。

首语

2022年2月11日,谷歌发布了首个 Android 13 开发者预览版。2022年7月,发布了Beta 4版本,接下来就是Final Relase版本了。是时候适配一波Android12了,为后面项目适配铺平道路。

介绍

2021年2月,谷歌发布了首个 Android 12开发者预览版,2021年10月5日谷歌发布Android 12正式版。

使用 Material You 打造的全新系统界面,富有表现力、活力和个性。使用重新设计的微件、AppSearch、游戏模式和新的编解码器扩展您的应用。支持隐私信息中心和大致位置等新的保护功能。使用富媒体内容插入功能、更简便的模糊处理功能、经过改进的原生调试功能等提高工作效率。

行为变更

应用启动画面

从Android 12开始,所有的App在每次启动时(特指冷启动与温启动),系统都会为我们加上一个默认的启动画面。 启动画面主要由4个元素组成

  • 应用图标:可以是静态或动画形式。默认情况下,使用Launcher图标。
  • 图标背景:可选,在图标与窗口背景之间需要更高的对比度时很有用。
  • 前景遮罩:可选,前景的 ⅓ 将被遮盖。
  • 窗口背景:不透明的单色,默认是所设置主题的windowBackground。
外观更改
  • 背景填充
代码语言:javascript
复制
<item name="android:windowSplashScreenBackground">@color/...</item>
  • 中心图标替换

如果通过AnimationDrawableAnimatedVectorDrawable实现动画效果,还需要设置windowSplashScreenAnimationDuration,以在显示启动页面的同时播放动画。

代码语言:javascript
复制
<item name="android:windowSplashScreenAnimatedIcon">@drawable/...</item>
  • 启动画面图标动画的时长
代码语言:javascript
复制
<item name="android:windowSplashScreenAnimationDuration">1000</item>
  • 启动画面图标后面的背景
代码语言:javascript
复制
<item name="android:windowSplashScreenIconBackgroundColor">@color/...</item>
  • 启动画面底部的图片
代码语言:javascript
复制
<item name="android:windowSplashScreenBrandingImage">@drawable/...</item>
  • 启动画面在初始化数据加载完关闭场景
代码语言:javascript
复制
val content: View = findViewById(android.R.id.content)
//绘制监听
content.viewTreeObserver.addOnPreDrawListener(
    object : ViewTreeObserver.OnPreDrawListener {
        override fun onPreDraw(): Boolean {
           return if(isFinsh){
               //数据加载完
               content.viewTreeObserver.removeOnPreDrawListener(this)
               true
           }else{
               false
           }

       }
   }
)
  • 自定义关闭启动画面的动画
代码语言:javascript
复制
        getSplashScreen().setOnExitAnimationListener { splashScreenView: SplashScreenView ->
            val slideUp = ObjectAnimator.ofFloat(
                splashScreenView,
                View.TRANSLATION_Y,
                0f, -splashScreenView.height.toFloat()
            )
            slideUp.interpolator = AnticipateInterpolator()
            slideUp.duration = 200L

            slideUp.doOnEnd { splashScreenView.remove() }

            slideUp.start()
        }
  • 计算动画的剩余时长
代码语言:javascript
复制
val animationDuration = splashScreenView.iconAnimationDuration
val animationStart = splashScreenView.iconAnimationStart
val remainingDuration = if (animationDuration != null && animationStart != null) {
    (animationDuration - Duration.between(animationStart, Instant.now()))
        .toMillis()
        .coerceAtLeast(0L)
} else {
    0L
}

用户使用App时会在视觉上感觉多个启动画面,可以通过Jetpack的SplashScreen库进行定制。

代码语言:javascript
复制
implementation 'androidx.core:core-splashscreen:1.0.0-alpha01'

启动页调用splashScreen.setKeepVisibleCondition{true}使得默认的启动画面持续覆盖原有的启动页,直到广告页开始显现时,才调用splashScreen.setKeepVisibleCondition{false}让页面重新显示,以此实现平稳过渡。

组件导出

以Android 12为目标平台的App,如果其包含的四大组件中使用到了Intent过滤器(intent-filter),则必须显式声明 android:exported 属性,否则App将无法在Android 12及更高系统版本的设备上安装 Manifest中Activity标签未设置android:exported属性error如下:

As of Android 12, android:exported must be set; use true to make the activity available to other apps, and false otherwise. For launcher activities, this should be set to true.

意思大概是:从 Android 12 开始,必须设置 android:exported;使用 true 使Activity可用于其他应用程序,否则使用 false。对于启动Activity,这应该设置为 true。 Merged Manifest也会出现Merging Errors:

Error: android:exported needs to be explicitly specified for . Apps targeting Android 12 and higher are required to specify an explicit value for android:exported when the corresponding component has an intent filter defined. See https://developer.android.com/guide/topics/manifest/activity-element#exported for details. Android12Test.app main manifest (this file)

这里有个棘手的问题是:依赖的第三方库使用到了intent-filter

解决方案:打包时会合并多个Module的AndroidManifest.xml文件,可以通过Gradle脚本,在打包过程中检索合并后的AndroidManifest.xml使用到intent-filter但没有声明android:exported属性的四大组件,动态添加android:exported属性。

脚本方案参考如下:http://events.jianshu.io/p/1913b48f2dad

安全和隐私设置
大致位置

Android提供了两种不同精确度的位置权限,分别是:

  • ACCESS_COARSE_LOCATION(大致位置) 提供设备位置的估算值,将范围限定在大约 1.6 公里(1 英里)内
  • ACCESS_FINE_LOCATION(确切位置) 通常将范围限定在大约 50 米(160 英尺)内,有时精确到几米(10 英尺)范围以内

在以Android 12 系统的APP上,请求ACCESS_FINE_LOCATION权限时,系统权限对话框会提供两个选项,即允许App获取确切位置,还是仅允许获取大致位置。

用户拒绝提供确切位置后,可再次请求获取确切位置。

在这次请求前可给用户添加权限说明来帮助获取确切位置,当然App也要做好大概位置的业务处理。 ##### 麦克风和摄像头切换开关 以Android 12为目标平台的App,用户状态栏新增麦克风使用权限和摄像头使用权限,可以一键启用/停用。

如果在画面录制过程中,关闭摄像头使用权限时,录制的会是空白画面;如果在声音录制过程中,关闭麦克风使用权限时,录制的会是无声音频。

官网提供了设备是否支持麦克风和摄像头切换开关的代码。

代码语言:javascript
复制
val sensorPrivacyManager = applicationContext
        .getSystemService(SensorPrivacyManager::class.java)
        as SensorPrivacyManager
val supportsMicrophoneToggle = sensorPrivacyManager
        .supportsSensorToggle(Sensors.MICROPHONE)
val supportsCameraToggle = sensorPrivacyManager
        .supportsSensorToggle(Sensors.CAMERA)

SensorPrivacyManager类提供麦克风和摄像头切换开关的信息,但由于是SystemApi( 调用系统API就必须要系统签名),无法调用。

代码语言:javascript
复制
@SystemApi
@RequiresPermission(Manifest.permission.OBSERVE_SENSOR_PRIVACY)
public boolean isSensorPrivacyEnabled(@Sensors.Sensor int sensor) {
   return isSensorPrivacyEnabled(sensor, UserHandle.USER_CURRENT);
}

如果用户主动关闭了摄像头或麦克风的使用权限,那么当下次App再需要启动摄像头或麦克风时,系统就会提醒用户,相关硬件的使用权限已关闭,并申请重新开启。

当应用使用麦克风或相机时,图标会出现在状态栏中。

Activity生命周期

以 Android 12 为目标平台的App,在根启动Activity(intent过滤器声明ACTION_MAIN和CATEGORY-LAUNCHER的Activity)页面按下返回按钮,系统会将 Activity 及其任务移到后台,而不是finish Activity。

自定义通知

以 Android 12 为目标平台的App,包含自定义内容视图的通知将不再使用完整通知区域;相反,系统会应用标准模板。为用户提供可看到且熟悉的通知展开功能,使所有通知保持外观一致且易于浏览。 所有通知都是可展开的。通常,这意味着,如果您使用的是 setCustomContentView,则还需要使用 setBigCustomContentView,以确保收起状态和展开状态保持一致。

权限重置

以 Android 12 为目标平台的App,用户几个月未与App互动,系统会自动重置授予的所有权限并将您的应用置于休眠状态。

待处理 intent 可变性

以 Android 12 为目标平台的App,构建PendingIntent时需要指定Flag为FLAG_IMMUTABLE(建议)或FLAG_MUTABLE二者之一,否则App将崩溃并出现以下error。

  • FLAG_IMMUTABLE,指示创建的 PendingIntent 应该是不可变的标志。
  • FLAG_MUTABLE,指示创建的 PendingIntent 应该是可变的标志。
代码语言:javascript
复制
if (Compatibility.isChangeEnabled(PENDING_INTENT_EXPLICIT_MUTABILITY_REQUIRED)
                && !flagImmutableSet && !flagMutableSet) {
            String msg = packageName + ": Targeting S+ (version " + Build.VERSION_CODES.S + " and above) requires that one of FLAG_IMMUTABLE or FLAG_MUTABLE  be specified when creating a PendingIntent.\nStrongly consider using FLAG_IMMUTABLE, only use FLAG_MUTABLE if some functionality depends on the PendingIntent being mutable, e.g. if it needs to be used with inline replies or bubbles.";
                throw new IllegalArgumentException(msg);
        }

对于使用的第三方库未正确指定Flag的问题,等待库更新或者使用同样功能的正确指定flag的库进行替代。

前台服务启动限制

以 Android 12 为目标平台的App,无法在后台运行时启动前台服务,否则会引发异常。

代码语言:javascript
复制
 if (fgRequired) {
            logFgsBackgroundStart(r);
            if (r.mAllowStartForeground == REASON_DENIED && isBgFgsRestrictionEnabled(r)) {
                String msg = "startForegroundService() not allowed due to "
                        + "mAllowStartForeground false: service "
                        + r.shortInstanceName;
                Slog.w(TAG, msg);
                showFgsBgRestrictedNotificationLocked(r);
                logFGSStateChangeLocked(r,
                        FrameworkStatsLog.FOREGROUND_SERVICE_STATE_CHANGED__STATE__DENIED,
                        0);
                if (CompatChanges.isChangeEnabled(FGS_START_EXCEPTION_CHANGE_ID, callingUid)) {
                    throw new ForegroundServiceStartNotAllowedException(msg);
                }
                return null;
            }
        }

考虑改用WorkManager在App后台运行时,启动完成加急工作。 通过adb命令,监控App是否有后台启动前台服务的行为,一旦发现,通知栏推送一条通知,定位到代码处。

代码语言:javascript
复制
adb shell device_config put activity_manager \ default_fgs_starts_restriction_notification_enabled true
精确的闹钟权限

以Android 12为目标平台的App,通过AlarmManager来设置定时任务,并且设置的是精确的闹钟(使用了setAlarmClock()setExact()setExactAndAllowWhileIdle()这几种方法),需要声明SCHEDULE_EXACT_ALARM权限声明且授权,否则会有如下error。

代码语言:javascript
复制
Caused by: java.lang.SecurityException: Caller com.yhj.Android12Test needs to hold android.permission.SCHEDULE_EXACT_ALARM to set exact alarm.

因此在AndroidManifest.xml清单文件中声明 SCHEDULE_EXACT_ALARM 权限,代码判断是否具有设置闹钟的权限。

代码语言:javascript
复制
private val singlePermissions=registerForActivityResult(ActivityResultContracts.RequestPermission()){isGranted ->
        when {
            isGranted -> Log.e("yhj", "申请成功")
            !ActivityCompat.shouldShowRequestPermissionRationale(
                this,
                Manifest.permission.SCHEDULE_EXACT_ALARM
            ) -> Log.e("yhj", "拒绝且不在询问")
            else -> Log.e("yhj", "拒绝")
        }
    }
通知 trampoline 限制

在配置通知的点按行为时,可能会通过PendingIntent来启动一个Service或BrocastReceiver。以Android 12为目标平台的App,如果尝试在Service或BrocastReceiver中内调用 startActivity(),系统会阻止该Activity启动,并在 Logcat 中显示以下消息:

Indirect notification activity start (trampoline) from PACKAGE_NAME, this should be avoided for performance reasons.

可通过adb命令识别在点按通知后,识别哪个Service或BrocastReceiver调用了startActivity(),并输出相关信息到Logcat,

代码语言:javascript
复制
adb shell dumpsys activity service \
com.android.systemui/.dump.SystemUIAuxiliaryDumpService
Toast提示重新设计

文本旁边显示应用图标,上限为两行文本。

新功能和API

Material You

Android 12 引入了一种名为Material you的新设计语言,可以理解它是Material Design的替代品。

依赖

代码语言:javascript
复制
implementation 'com.google.android.material:material:1.8.0-alpha01'

提供一个官方文档及源码供使用学习。

圆角API

Android 12 引入了 RoundedCornerWindowInsets.getRoundedCorner(int position),它们可以提供圆角的半径和中心点。

通知的丰富图片支持

以Android 12为目标平台的App,可以通过在 MessagingStyle()BigPictureStyle()通知中提供动画图片来丰富应用的通知体验。此外,您的应用现在还可以让用户在从通知栏回复消息时发送图片消息。

蓝牙权限

Android 12 引入了 BLUETOOTH_SCAN(寻找蓝牙设备)、BLUETOOTH_ADVERTISE(当前设备可被其他蓝牙设备发现)和 BLUETOOTH_CONNECT(与已配对的蓝牙设备通信)权限。

自动更新应用

使用 PackageInstallerAPI 的应用引入了 setRequireUserAction()方法。此方法可让安装程序应用执行应用更新而无需用户确认操作。

设备芯片组信息

Android 12 向 android.os.Build 添加了两个常量, Build.SOC_MANUFACTURER(设备主要片上系统的制造商)和 Build.SOC_MODEL (设备上主要片上系统的型号名称)

总结

更多变更细节参考官网:https://developer.android.google.cn/about/versions/12

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 首语
  • 介绍
  • 行为变更
    • 应用启动画面
      • 外观更改
    • 组件导出
      • 安全和隐私设置
        • 大致位置
      • Activity生命周期
        • 自定义通知
          • 权限重置
            • 待处理 intent 可变性
              • 前台服务启动限制
                • 精确的闹钟权限
                  • 通知 trampoline 限制
                    • Toast提示重新设计
                    • 新功能和API
                      • Material You
                        • 圆角API
                          • 通知的丰富图片支持
                            • 蓝牙权限
                              • 自动更新应用
                                • 设备芯片组信息
                                • 总结
                                领券
                                问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档