場景:當啟動頁處于倒計時階段,用戶將其切換為后臺的多任務卡片狀態,倒計時會繼續執行,直到最后執行相關邏輯(一般會跳轉引導頁、進入主頁等)
期望:而綜合市場來看,一般我們期望的是當其處于多卡片狀態,需要暫停倒計時,只有恢復前臺狀態后繼續計時。而不是重新計時或已計時完畢
關于啟動頁的一些基礎內容,之前已經做過總結了,此篇主要用于解決上方提到的業務場景
- Android進階之路 - Splash、Welcome歡迎頁面簡單實現(當年入門時候寫的,Demo級入門示例)
- Android進階之路 - 快速實現啟動頁(基礎版,可用于實戰項目)
業務實戰
- 項目實戰
- AI提供方案
- CountDownTimer + 生命周期感知
- ViewModel + LiveData
項目實戰
以下是我從項目中剝離的偽代碼,主要用于解決不同生命周期,計時器帶來的影響,核心思想有以下幾點
- 倒計時長根據當前計時器的變化而實時變更
- 當處于
onPause
(后臺)時,取消計時器 - 當處于
onResume
(前臺)時,將計時器剩余時長傳入計時器中
因為我們不考慮橫豎屏切換場景,所以在 AndroidMainfest
中直接為啟動頁 Activityandroid:screenOrientation="portrait"
<activityandroid:name=".loading.SplashActivity"android:exported="true"android:screenOrientation="portrait"android:theme="@style/SplashTheme"><intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /></intent-filter></activity>
實現方式
package cn.xxxximport android.annotation.SuppressLint
import android.content.Context
import android.content.Intent
import android.os.Bundle
import android.os.CountDownTimer
import android.view.View
import android.view.ViewGroup
import android.widget.ImageView
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
import androidx.core.view.isVisible
import androidx.lifecycle.lifecycleScope
import kotlinx.coroutines.*
import me.jessyan.autosize.internal.CancelAdapt
import timber.log.Timber
import javax.inject.Inject@SuppressLint("CustomSplashScreen")
@AndroidEntryPoint
class SplashActivity : AppCompatActivity(), CancelAdapt {lateinit var tvJump: TextView// 倒計時長var remainingTimeInMillis: Long? = null//計時器private var countDownTimer: CountDownTimer? = null@SuppressLint("SourceLockedOrientationActivity", "MissingInflatedId")override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_splash_l)//右上角跳過的視圖tvJump = findViewById<TextView>(R.id.tv_jump)//初始化為計時器時間remainingTimeInMillis = 5 * 1000//跳過邏輯tvJump.onClick {countDownTimer?.cancel()next()}}override fun onResume() {super.onResume()//之所以寫是因為在項目里廣告時間是后臺返回,如果只是單純固定時長可去除該判斷if (!remainingTimeInMillis.isNull()) {// Activity回到前臺時,檢查剩余時間if ((remainingTimeInMillis ?: 0) <= 0) {// 如果時間已經耗盡,直接跳轉next()} else {// 如果時間還有剩余,重新啟動一個計時器,從剩余時間開始startTimer(remainingTimeInMillis ?: 0)}}}override fun onPause() {super.onPause()// Activity進入后臺時,立即取消計時器(防止onFinish在后臺被調用),remainingTimeInMillis還保存著最新的剩余時間countDownTimer?.cancel()}//計時器private fun startTimer(time: Long) {countDownTimer?.cancel()countDownTimer = object : CountDownTimer(time, 1000) {override fun onTick(millisUntilFinished: Long) {//實時更新剩余的倒計時長remainingTimeInMillis = millisUntilFinishedmainHandler.post { tvJump.text = "${millisUntilFinished / 1000 + 1}s跳過" }}override fun onFinish() {//倒計時結束,進入對應邏輯next()}}.start()}override fun onDestroy() {super.onDestroy()countDownTimer?.cancel()countDownTimer = null}private fun next() {//可自行根據業務場景,決定跳轉邏輯 // 以下為項目偽代碼:判斷是否首次登錄,運行過幫助引導val landingVersion = SPUtils.AppSP().get(ConstValue.VER_IS_THIS_VERSION_OPEN_BEFORE, 0) as? Int?if ((landingVersion ?: 0) >= 4) {RouterPath.APP_MAIN_ACT //首頁} else {RouterPath.MAIN_LANDING_ACT //引導頁}.also {startRouterAndFinish(it) { putBoolean("firstStart", true) }}}
}
activity_splash_l
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:tools="http://schemas.android.com/tools"android:layout_width="match_parent"android:layout_height="match_parent"android:background="@color/white"android:orientation="vertical"tools:ignore="MissingDefaultResource"><ImageViewandroid:id="@+id/background_type_1"android:layout_width="match_parent"android:layout_height="match_parent"android:scaleType="fitXY"android:src="@drawable/drawable_app_launch"android:visibility="visible" /><RelativeLayoutandroid:layout_width="wrap_content"android:layout_height="wrap_content"android:layout_gravity="right"android:layout_marginTop="62dp"android:layout_marginEnd="15dp"android:background="@drawable/shape_splash_btn_jump_bg"android:paddingHorizontal="12dp"android:paddingVertical="4dp"><TextViewandroid:id="@+id/tv_jump"android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="跳過"android:textColor="#FFFFFF"android:textSize="12dp" /></RelativeLayout>
</FrameLayout>
AI提供方案
自從使用AI后,覺得很多基礎性的知識沒有了記Blog的必要,更多的可能還行記錄項目中遇到的問題
CountDownTimer + 生命周期感知
考慮到了橫豎屏場景,兼容場景更多一些
核心要點
- 在
onPause()
中取消計時器:阻止它在后臺觸發onFinish()
跳轉。 - 保存剩余時間:在
onTick()
中持續更新remainingTimeInMillis
變量。 - 在
onResume()
中恢復計時:根據保存的剩余時間重新開始計時。如果時間已到,直接跳轉。 - 處理配置變更:通過
onSaveInstanceState
保存數據,防止屏幕旋轉等問題。
class CountdownActivity : AppCompatActivity() {private var countDownTimer: CountDownTimer? = nullprivate var remainingTimeInMillis: Long = 10000 // 總計時時間,例如10秒private val totalTimeInMillis: Long = 10000 // 保存總時間用于恢復override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_countdown)// 從保存的狀態中恢復時間(防止旋轉屏幕等配置變更)if (savedInstanceState != null) {remainingTimeInMillis = savedInstanceState.getLong("REMAINING_TIME", totalTimeInMillis)}startCountdown(remainingTimeInMillis)}override fun onSaveInstanceState(outState: Bundle) {super.onSaveInstanceState(outState)// 保存當前剩余時間,防止配置變更(如屏幕旋轉)導致時間重置outState.putLong("REMAINING_TIME", remainingTimeInMillis)}private fun startCountdown(millisInFuture: Long) {// 每次啟動新計時器前,取消舊的countDownTimer?.cancel()countDownTimer = object : CountDownTimer(millisInFuture, 1000) {override fun onTick(millisUntilFinished: Long) {// 更新UI,顯示剩余時間remainingTimeInMillis = millisUntilFinishedval seconds = millisUntilFinished / 1000textView_countdown.text = "剩余時間: ${seconds}秒"}override fun onFinish() {// 只有在Activity處于前臺時,才執行跳轉邏輯proceedToNextStep()}}.start()}private fun proceedToNextStep() {// 執行你的下一步操作,例如跳轉頁面val intent = Intent(this, NextActivity::class.java)startActivity(intent)finish()}override fun onPause() {super.onPause()// Activity進入后臺時,立即取消計時器(防止onFinish在后臺被調用)countDownTimer?.cancel()// 注意:這里我們只是取消了計時器,并沒有改變remainingTimeInMillis的值// 所以remainingTimeInMillis還保存著最新的剩余時間}override fun onResume() {super.onResume()// Activity回到前臺時,檢查剩余時間if (remainingTimeInMillis <= 0) {// 如果時間已經耗盡,直接跳轉proceedToNextStep()} else {// 如果時間還有剩余,重新啟動一個計時器,從剩余時間開始startCountdown(remainingTimeInMillis)}}override fun onDestroy() {super.onDestroy()// 徹底銷毀Activity時,釋放計時器資源countDownTimer?.cancel()}
}
ViewModel + LiveData
符合當下主流框架、組件,適用性、兼容性高,但是對于未使用過的朋友,需要一點時間學下組件
Android Architecture Components 架構組件
- 組件化之路 - Lifecycle一知半解
- 組件化之路 - LiveData一知半解
- 組件化之路 - ViewModel一知半解
- 組件化之路 - LiveData + ViewModel一知半解
優勢
- 生命周期感知:
ViewModel
獨立于UI生命周期,配置變更時數據不會丟失。 - 關注點分離:計時邏輯在
ViewModel
中,UI控制只在Activity中。 - 更健壯:使用
Coroutines
處理后臺任務,更加現代和安全。
創建 ViewModel
import androidx.lifecycle.LiveData
import androidx.lifecycle.MutableLiveData
import androidx.lifecycle.ViewModel
import androidx.lifecycle.viewModelScope
import kotlinx.coroutines.Job
import kotlinx.coroutines.delay
import kotlinx.coroutines.isActive
import kotlinx.coroutines.launchclass CountdownViewModel : ViewModel() {private val _remainingTime = MutableLiveData<Long>()val remainingTime: LiveData<Long> = _remainingTimeprivate val _countdownFinished = MutableLiveData<Boolean>()val countdownFinished: LiveData<Boolean> = _countdownFinishedprivate var countdownJob: Job? = nullprivate var initialDuration: Long = 0Lfun startCountdown(duration: Long) {initialDuration = duration_remainingTime.value = duration_countdownFinished.value = falsecountdownJob?.cancel() // 取消之前的任務countdownJob = viewModelScope.launch {var timeLeft = durationwhile (timeLeft > 0 && isActive) {delay(1000)timeLeft -= 1000_remainingTime.postValue(timeLeft) // 使用postValue確保在主線程更新}if (isActive && timeLeft <= 0) {_countdownFinished.postValue(true)}}}fun pauseCountdown() {countdownJob?.cancel()}// 獲取當前剩余時間,用于在UI層判斷fun getCurrentTime(): Long = _remainingTime.value ?: initialDurationoverride fun onCleared() {super.onCleared()pauseCountdown()}
}
在 Activity/Fragment 中使用 ViewModel
class CountdownActivity : AppCompatActivity() {private lateinit var viewModel: CountdownViewModeloverride fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_countdown)// 初始化ViewModelviewModel = ViewModelProvider(this).get(CountdownViewModel::class.java)// 觀察剩余時間并更新UIviewModel.remainingTime.observe(this) { timeMillis ->val seconds = timeMillis / 1000textView_countdown.text = "剩余時間: ${seconds}秒"}// 觀察倒計時是否結束viewModel.countdownFinished.observe(this) { isFinished ->if (isFinished) {proceedToNextStep()}}// 如果是第一次創建,開始計時if (savedInstanceState == null) {viewModel.startCountdown(10000)}}private fun proceedToNextStep() {val intent = Intent(this, NextActivity::class.java)startActivity(intent)finish()}override fun onPause() {super.onPause()// 進入后臺時暫停計時viewModel.pauseCountdown()}override fun onResume() {super.onResume()val currentTime = viewModel.getCurrentTime()if (currentTime <= 0) {// 如果ViewModel中記錄的時間已經用完,直接跳轉proceedToNextStep()} else {// 否則,重新開始計時(從剩余時間開始)viewModel.startCountdown(currentTime)}}
}