首页 文章 精选 留言 我的

精选列表

搜索[android things],共10000篇文章
优秀的个人博客,低调大师

Mac系统下利用ADB命令连接android手机并进行文件操作

1 获取序列号:adb get-serialno 2 查看连接计算机的设备:adb devices 3 重启机器:adb reboot 4 重启到bootloader,即刷机模式:adb reboot bootloader 5 重启到recovery,即恢复模式:adb reboot recovery 6 查看log:adb logcat 7 终止adb服务进程:adb kill-server 8 重启adb服务进程:adb start-server 9 获取机器MAC地址:adb shell cat /sys/class/net/wlan0/address 10 获取CPU序列号:adb shell cat /proc/cpuinfo 11 安装APK:adb install <apkfile> //比如:adb install baidu.apk 12 保留数据和缓存文件,重新安装apk:adb install -r <apkfile> //比如:adb install -r baidu.apk 13 安装apk到sd卡:adb install -s <apkfile> // 比如:adb install -s baidu.apk 14 卸载APK:adb uninstall <package> //比如:adb uninstall com.baidu.search 15 卸载app但保留数据和缓存文件:adb uninstall -k <package> //比如:adb uninstall -k com.baidu.search 16 启动应用:adb shell am start -n <package_name>/.<activity_class_name> 17 查看设备cpu和内存占用情况:adb shell top 18 查看占用内存前6的app:adb shell top -m 6 19 刷新一次内存信息,然后返回:adb shell top -n 1 20 查询各进程内存使用情况:adb shell procrank 21 杀死一个进程:adb shell kill [pid] 22 查看进程列表:adb shell ps 23 查看指定进程状态:adb shell ps -x [PID] 24 查看后台services信息:adb shell service list 25 查看当前内存占用:adb shell cat /proc/meminfo 26 查看IO内存分区:adb shell cat /proc/iomem 27 将system分区重新挂载为可读写分区:adb remount 28 从本地复制文件到设备:adb push <local> <remote> 29 从设备复制文件到本地:adb pull <remote> <local> 30 列出目录下的文件和文件夹,等同于dos中的dir命令:adb shell ls 31 进入文件夹,等同于dos中的cd 命令:adb shell cd <folder> 32 重命名文件:adb shell rename path/oldfilename path/newfilename 33 删除system/avi.apk:adb shell rm /system/avi.apk 34 删除文件夹及其下面所有文件:adb shell rm -r <folder> 35 移动文件:adb shell mv path/file newpath/file 36 设置文件权限:adb shell chmod 777 /system/fonts/DroidSansFallback.ttf 37 新建文件夹:adb shell mkdir path/foldelname 38 查看文件内容:adb shell cat <file> 39 查看wifi密码:adb shell cat /data/misc/wifi/*.conf 40 清除log缓存:adb logcat -c 41 查看bug报告:adb bugreport 42 获取设备名称:adb shell cat /system/build.prop 43 查看ADB帮助:adb help 44 跑monkey:adb shell monkey -v -p your.package.name 500

优秀的个人博客,低调大师

Android后台任务可靠性排查:从WorkManager 观测到失败重试闭环

后台同步最难处理的部分,往往不是把任务提交给 WorkManager,而是回答“它为什么没有按预期完成”。本文以一个离线优先的资料同步任务为例,梳理约束条件、任务状态、失败分类、重试策略和幂等落库,建立一条可以在本地与线上复用的排查闭环。 ## 先定义任务的完成语义 “同步成功”不能只等同于接口返回 HTTP 200。一个完整任务至少要明确四个结果: - 服务端数据已经拉取并通过基本校验。 - 本地事务已经提交,下一次读取能够看到新数据。 - 当前任务不会因为重复执行产生重复记录或错误覆盖。 - 失败时能够判断是应该重试、等待约束满足,还是直接结束。 如果这些语义没有先定义,排查时看到 `SUCCEEDED` 也可能只是“请求成功”,并不代表本地数据可用。 ## 约束决定任务何时有机会运行 WorkManager 会综合网络、电量、充电和存储等约束决定任务是否可以启动。约束不满足时,任务通常停留在 `ENQUEUED`,这不是执行失败。 ``` val constraints = Constraints.Builder() .setRequiredNetworkType(NetworkType.CONNECTED) .setRequiresBatteryNotLow(true) .build() val request = OneTimeWorkRequestBuilder() .setConstraints(constraints) .setBackoffCriteria( BackoffPolicy.EXPONENTIAL, 30, TimeUnit.SECONDS ) .setInputData(workDataOf("reason" to "manual_refresh")) .addTag("profile-sync") .build() WorkManager.getInstance(context).enqueueUniqueWork( "profile-sync", ExistingWorkPolicy.KEEP, request ) ``` 这里有三个容易被忽略的点: - `CONNECTED` 只表示存在网络连接,不保证接口可达,也不保证服务端健康。 - 指数退避的最短间隔会受到 WorkManager 限制,不能把它当作精确的定时器。 - `KEEP` 会保留已经存在的唯一任务。用户点击刷新后没有新任务,不一定是提交失败,可能是旧任务仍在队列中。 ## 用唯一任务和标签保留可观测性 任务名适合表达业务上的唯一工作,标签适合按业务维度查询。不要只保存 `WorkRequest` 对象,因为进程重启后它不会替你保留诊断上下文。 ``` suspend fun observeSync(workManager: WorkManager): SyncSnapshot { val work = workManager .getWorkInfosForUniqueWork("profile-sync") .firstOrNull() return when { work == null -> SyncSnapshot.NotScheduled work.state == WorkInfo.State.RUNNING -> SyncSnapshot.Running work.state == WorkInfo.State.ENQUEUED -> SyncSnapshot.Waiting(work.runAttemptCount, work.constraints) work.state == WorkInfo.State.SUCCEEDED -> SyncSnapshot.Success work.state == WorkInfo.State.FAILED -> SyncSnapshot.Failed(work.outputData.getString("error")) else -> SyncSnapshot.Cancelled } } ``` 真实项目中建议把以下信息写入日志或本地诊断表:任务唯一名、请求原因、创建时间、开始时间、结束时间、运行次数、最后一次错误类型和数据版本。日志中不要写入 token、完整用户资料或接口响应原文。 ## 正确区分失败和重试 `CoroutineWorker.doWork()` 返回 `Result.retry()` 时,WorkManager 会按照退避策略重新调度;返回 `Result.failure()` 则表示任务终止。判断标准应该是错误是否具有临时性,而不是简单地“所有异常都重试”。 ``` class SyncWorker( appContext: Context, params: WorkerParameters, private val repository: SyncRepository ) : CoroutineWorker(appContext, params) { override suspend fun doWork(): Result { return try { repository.syncOnce() Result.success() } catch (e: IOException) { Result.retry() } catch (e: HttpException) { if (e.code() == 408 || e.code() == 429 || e.code() >= 500) { Result.retry() } else { Result.failure(workDataOf("error" to "http_${e.code()}")) } } catch (e: InvalidPayloadException) { Result.failure(workDataOf("error" to "invalid_payload")) } } } ``` 常见分类可以这样处理:网络断开、连接超时、服务端 5xx 和限流通常适合重试;鉴权失效、参数错误和无法解析的协议变更应该失败并触发业务告警。对于重试次数,还要考虑服务端是否支持幂等,以及任务是否会被系统重启后再次执行。 ## 重试必须建立在幂等之上 假设同步接口返回同一条资料两次,直接 `insert` 可能造成重复数据。更稳妥的做法是让服务端对象携带稳定主键,在 Room 中使用唯一索引,并在一个事务中完成版本判断与写入。 ``` @Entity( tableName = "profile", indices = [Index(value = ["remoteId"], unique = true)] ) data class ProfileEntity( @PrimaryKey(autoGenerate = true) val localId: Long = 0, val remoteId: String, val version: Long, val name: String ) @Transaction suspend fun replaceIfNewer(items: List) { items.forEach { item -> val old = profileDao.findByRemoteId(item.remoteId) if (old == null || item.version > old.version) { profileDao.upsert(item) } } } ``` 如果接口支持增量同步,建议把服务端游标和资料更新放到同一个本地事务中。只有资料写入成功后才推进游标,避免游标先前移、数据却没有落库,最终造成不可恢复的漏同步。 ## 从状态反推故障位置 排查可以按下面顺序进行: 1. 先查询唯一任务是否存在,确认是没有提交、被 `KEEP` 合并,还是已经完成。 2. 如果状态是 `ENQUEUED`,查看约束、初始延迟、重试次数和是否被暂停。 3. 如果状态是 `RUNNING`,检查 Worker 是否卡在网络、数据库事务或锁等待。 4. 如果状态是 `FAILED`,读取受控的错误码,并关联最近一次运行日志。 5. 如果状态是 `SUCCEEDED`,直接查询本地数据和同步游标,不要只看任务状态。 6. 检查任务是否被取消,以及取消来源是用户操作、应用登出还是系统策略。 可以在调试页面展示脱敏后的任务快照,给测试和客服一个稳定的证据入口。线上则将任务名、错误码、运行次数和耗时接入统一日志,不依赖开发者手工复现。 ## 常见误区 ### 把 WorkManager 当作实时执行器 它适合可延迟、可保证最终执行的后台工作,不适合秒级刷新、持续音频处理或必须立即完成的交互。实时场景应选择前台服务、推送或应用内主动请求等更匹配的机制。 ### 在 Worker 中无限等待 网络请求、互斥锁和数据库操作都应该有超时边界。无限挂起会让任务长期处于 `RUNNING`,同时占用系统调度资源,最终让后续诊断失去方向。 ### 只在 UI 层观察任务 UI 进程可能被销毁,界面观察也可能因为页面离开而停止。任务诊断应沉淀在 repository 或诊断表,UI 只是读取快照并展示。 ## 小结 可靠的后台任务不是“提交一个 Worker”这么简单,而是一套可解释的系统:约束说明何时执行,唯一任务说明如何合并,状态和日志说明发生了什么,错误分类决定是否重试,幂等事务保证重复执行不会破坏数据。把这些信息串起来后,后台同步从“偶尔失效”变成可以定位、修复和验证的工程问题。

优秀的个人博客,低调大师

[Android 从零到一] Paging 3 RemoteMediator 实战:构建离线优先的分页列表

# Paging 3 RemoteMediator 实战:构建离线优先的分页列表 只从网络分页,断网后页面就会失去内容;只从数据库读取,又需要自己处理拉取、缓存和翻页。`RemoteMediator` 把两者连接起来:界面始终观察 Room,网络负责按需补充数据。本文以资讯列表为例,逐步实现一套可刷新、可续页、可离线浏览的分页方案,并解释其中最容易出错的数据一致性问题。 ## 为什么要让数据库成为唯一数据源 一个常见实现是首次进入页面请求网络,失败时再读取缓存。这个方案看似直接,却会产生两套状态:网络结果一套,数据库结果一套。刷新、删除、排序变化后,两套数据很容易不同步。 离线优先架构采用另一种数据流: - UI 只订阅 Room 返回的 `PagingSource`; - `RemoteMediator` 判断何时请求网络; - 网络结果在事务中写入 Room; - Room 变更后自动使旧的 `PagingSource` 失效; - UI 从新快照中得到最新列表。 这样,网络响应不会直接交给页面。数据库是页面状态的唯一事实来源,在线和离线走的是同一条渲染链路。 ## 数据表不能只存业务实体 假设服务端接口按页码返回资讯: ``` data class ArticleDto( val id: Long, val title: String, val summary: String, val publishedAt: Long ) data class ArticlePage( val items: List, val page: Int, val hasMore: Boolean ) ``` 本地至少需要业务表和远程键表。业务表保存页面真正展示的数据: ``` @Entity(tableName = "articles") data class ArticleEntity( @PrimaryKey val id: Long, val title: String, val summary: String, val publishedAt: Long ) ``` 远程键记录每条数据相邻页的位置。它不是页面展示数据,却是恢复分页边界的关键: ``` @Entity(tableName = "article_remote_keys") data class ArticleRemoteKey( @PrimaryKey val articleId: Long, val previousPage: Int?, val nextPage: Int? ) ``` 不要用“当前请求到了哪一页”这样的内存变量代替远程键。进程重建、主动刷新或列表重新创建后,内存变量会丢失,也无法和数据库快照保持原子一致。 ## DAO 与数据库定义 `PagingSource` 的查询顺序必须稳定。若多个数据拥有相同发布时间,应增加主键作为次级排序条件,否则翻页过程中可能出现顺序抖动。 ``` @Dao interface ArticleDao { @Query( """ SELECT * FROM articles ORDER BY publishedAt DESC, id DESC """ ) fun pagingSource(): PagingSource @Insert(onConflict = OnConflictStrategy.REPLACE) suspend fun upsertAll(items: List) @Query("DELETE FROM articles") suspend fun clearAll() } @Dao interface ArticleRemoteKeyDao { @Query("SELECT * FROM article_remote_keys WHERE articleId = :id") suspend fun remoteKeyById(id: Long): ArticleRemoteKey? @Insert(onConflict = OnConflictStrategy.REPLACE) suspend fun insertAll(keys: List) @Query("DELETE FROM article_remote_keys") suspend fun clearAll() } ``` 数据库还需要暴露事务能力: ``` @Database( entities = [ArticleEntity::class, ArticleRemoteKey::class], version = 1 ) abstract class AppDatabase : RoomDatabase() { abstract fun articleDao(): ArticleDao abstract fun articleRemoteKeyDao(): ArticleRemoteKeyDao } ``` ## 实现 RemoteMediator 的加载决策 `load()` 会收到三种加载类型: - `REFRESH`:首次加载或用户主动刷新; - `PREPEND`:向列表头部加载; - `APPEND`:向列表尾部加载。 对于只支持向后翻页的接口,`PREPEND` 可以直接结束。`REFRESH` 从起始页请求,`APPEND` 则从列表末尾数据对应的远程键中取得下一页。 ``` @OptIn(ExperimentalPagingApi::class) class ArticleRemoteMediator( private val api: ArticleApi, private val database: AppDatabase ) : RemoteMediator() { private val articleDao = database.articleDao() private val remoteKeyDao = database.articleRemoteKeyDao() override suspend fun load( loadType: LoadType, state: PagingState ): MediatorResult { val page = when (loadType) { LoadType.REFRESH -> STARTING_PAGE LoadType.PREPEND -> return MediatorResult.Success( endOfPaginationReached = true ) LoadType.APPEND -> { val lastItem = state.lastItemOrNull() ?: return MediatorResult.Success( endOfPaginationReached = false ) val key = remoteKeyDao.remoteKeyById(lastItem.id) ?: return MediatorResult.Success( endOfPaginationReached = false ) key.nextPage ?: return MediatorResult.Success( endOfPaginationReached = true ) } } return try { val response = api.getArticles( page = page, pageSize = state.config.pageSize ) val entities = response.items.map(ArticleDto::toEntity) val endReached = !response.hasMore || entities.isEmpty() database.withTransaction { if (loadType == LoadType.REFRESH) { remoteKeyDao.clearAll() articleDao.clearAll() } val previousPage = if (page == STARTING_PAGE) null else page - 1 val nextPage = if (endReached) null else page + 1 val keys = entities.map { article -> ArticleRemoteKey( articleId = article.id, previousPage = previousPage, nextPage = nextPage ) } remoteKeyDao.insertAll(keys) articleDao.upsertAll(entities) } MediatorResult.Success(endOfPaginationReached = endReached) } catch (exception: IOException) { MediatorResult.Error(exception) } catch (exception: HttpException) { MediatorResult.Error(exception) } } private fun ArticleDto.toEntity() = ArticleEntity( id = id, title = title, summary = summary, publishedAt = publishedAt ) companion object { private const val STARTING_PAGE = 1 } } ``` 这里有一个容易忽略的细节:当 `APPEND` 时列表暂时为空,不应立刻断定已经到达末尾。返回 `endOfPaginationReached = false`,让 Paging 在数据库快照稳定后继续判断,通常更符合预期。 ## 为什么写入必须放在同一个事务里 刷新时需要依次清理远程键、清理旧数据、写入新远程键、写入新数据。如果这些操作不在同一个事务中,应用可能在中间状态被终止,留下“有数据但没有键”或“有键但没有数据”的数据库。 事务还避免 UI 观察到短暂的空列表。Room 会在事务提交后统一通知查询失效,页面拿到的是一致的新快照。 不过,刷新时无条件清空也有体验代价:服务端请求成功但返回解析异常时,旧缓存可能已被删除。正确顺序是先在事务外完成请求和数据转换,确认结果可用后,再进入事务替换缓存。 ## 配置 Pager 和 Repository Repository 同时提供 `RemoteMediator` 和 Room 的 `PagingSource`: ``` class ArticleRepository( private val api: ArticleApi, private val database: AppDatabase ) { @OptIn(ExperimentalPagingApi::class) fun articleStream(): Flow> = Pager( config = PagingConfig( pageSize = 20, prefetchDistance = 5, initialLoadSize = 40, enablePlaceholders = false ), remoteMediator = ArticleRemoteMediator(api, database), pagingSourceFactory = { database.articleDao().pagingSource() } ).flow } ``` `pageSize` 最好和服务端支持的分页大小一致。`prefetchDistance` 太大会过早触发请求,太小则可能在用户滑到底部时出现等待。是否开启占位符取决于数据源能否提供稳定总数,普通网络分页通常关闭更简单。 ViewModel 应缓存分页流,避免配置变化后重新建立整条加载链路: ``` class ArticleViewModel( repository: ArticleRepository ) : ViewModel() { val articles = repository.articleStream() .cachedIn(viewModelScope) } ``` ## 页面要区分刷新和追加状态 `CombinedLoadStates` 同时包含本地 `source` 和远端 `mediator` 的状态。离线优先页面通常更关心 `mediator`,因为网络错误来自这里,而已缓存的数据仍可能正常显示。 ``` lifecycleScope.launch { repeatOnLifecycle(Lifecycle.State.STARTED) { viewModel.articles.collectLatest(adapter::submitData) } } lifecycleScope.launch { repeatOnLifecycle(Lifecycle.State.STARTED) { adapter.loadStateFlow.collectLatest { states -> val refresh = states.mediator?.refresh binding.progress.isVisible = refresh is LoadState.Loading && adapter.itemCount == 0 binding.swipeRefresh.isRefreshing = refresh is LoadState.Loading && adapter.itemCount > 0 binding.errorGroup.isVisible = refresh is LoadState.Error && adapter.itemCount == 0 binding.offlineHint.isVisible = refresh is LoadState.Error && adapter.itemCount > 0 } } } ``` 有缓存时网络失败,不应把整个页面替换成错误页。保留列表并显示轻量提示,用户仍可浏览本地内容。只有无缓存且刷新失败时,才展示全屏错误状态。 列表底部可以使用 `LoadStateAdapter` 展示追加加载和重试按钮: ``` binding.recyclerView.adapter = adapter.withLoadStateFooter( footer = ArticleLoadStateAdapter(adapter::retry) ) ``` 主动刷新调用 `adapter.refresh()`,失败后的原请求重试调用 `adapter.retry()`。两者语义不同,不应混用。 ## 缓存过期策略 默认情况下,每次创建新的 `Pager` 都可能触发刷新。若希望短时间内复用缓存,可覆写 `initialize()`: ``` override suspend fun initialize(): InitializeAction { val lastUpdated = cacheMetaDao.lastUpdatedAt() ?: return LAUNCH_INITIAL_REFRESH val cacheTimeout = TimeUnit.MINUTES.toMillis(30) return if (System.currentTimeMillis() - lastUpdated < cacheTimeout) { SKIP_INITIAL_REFRESH } else { LAUNCH_INITIAL_REFRESH } } ``` 更新时间应在成功写入网络结果的同一事务中更新。不要只记录“请求发起时间”,否则失败请求也会让陈旧缓存被误判为新鲜。 内容型列表可以使用较长缓存时间,价格、库存等高时效数据则应缩短,甚至每次进入都刷新。缓存策略是业务决策,不是一个适用于所有页面的固定常量。 ## 排查重复、跳页与死循环 线上分页问题往往不是 Paging 本身失效,而是边界定义不一致。可以按以下顺序检查: - 服务端排序是否稳定,翻页期间新数据插入会不会改变页码边界; - 业务表主键是否真能唯一标识条目; - `nextPage` 是否在末页正确写为 `null`; - 空响应是否被识别为分页结束; - 刷新时业务表和远程键是否一起清理; - DAO 查询排序是否与服务端排序一致; - 多个筛选条件是否错误共用了同一套缓存和远程键。 若列表支持分类、关键词或用户维度,远程键的主键不能只有 `articleId`。更稳妥的方式是为查询参数生成 `queryKey`,远程键使用 `(queryKey, articleId)` 复合主键,业务缓存也要明确数据属于哪个查询。否则切换筛选条件后,会读到上一种条件留下的翻页位置。 页码分页天然容易受服务端数据插入影响。接口可控时,优先使用稳定游标,让服务端返回 `nextCursor`,远程键保存游标而不是页码,可以显著减少重复和遗漏。 ## 测试加载状态与事务结果 `RemoteMediator` 的核心逻辑可以使用内存 Room 和假接口测试。至少覆盖这些分支: - 首次刷新写入数据及远程键; - 刷新替换旧缓存; - 追加请求使用正确的下一页; - 末页返回分页结束; - 网络异常保留旧缓存; - 重复主键被更新而不是插入两份; - 不同查询条件之间互不污染。 测试时不要只断言 `MediatorResult.Success`,还应查询数据库,验证业务数据、顺序和远程键是一致的。真正影响页面的是事务提交后的数据库状态。 ## 适用边界 `RemoteMediator` 适合列表较大、需要增量加载、允许本地缓存,并且服务端具有明确分页协议的场景。数据量很小的一次性接口没有必要引入整套分页基础设施;实时消息流也更适合 WebSocket、增量同步和独立的本地落库策略。 离线优先不等于永不请求网络,而是把缓存、同步和展示的职责划清:UI 可信地读取本地状态,网络同步可失败、可重试,数据库提交保证状态一致。当这些边界稳定后,分页列表才能在断网、进程重建和频繁刷新下保持可预测。

资源下载

更多资源
优质分享App

优质分享App

近一个月的开发和优化,本站点的第一个app全新上线。该app采用极致压缩,本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长,特征是大鼻子、头戴帽子、身穿背带裤,还留着胡子。与他的双胞胎兄弟路易基一起,长年担任任天堂的招牌角色。

Nacos

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Spring

Spring

Spring框架(Spring Framework)是由Rod Johnson于2002年提出的开源Java企业级应用框架,旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念,提供核心容器、应用上下文、数据访问集成等模块,支持整合Hibernate、Struts等第三方框架,其适用范围不仅限于服务器端开发,绝大多数Java应用均可从中受益。

用户登录
用户注册
修改密码
忘记密码