再看想象一个场景。你的相机应用拍了一张照片，现在想通过微信分享。微信如何访问你相机应用的私有数据？怎么说呢，如果直接给文件方法，会因为权限限制无法访问；如果把文件复制一份，浪费存储空间…，这就是ContentProvider要解决的主要问题——在保证安全的前提下实现跨应用数据共享。不过，

通过Uri权限机制。应用可以临时授权其他应用访问特定数据，无需暴露文件程序方法，也不需要使用者授予运行时权限。

在上一篇任务调度中，看到Android如何智能管理后台任务；今天我们将看到，Android如何在多个应用之间安全共享数据。

一、ContentProvider整体架构

架构设计哲学

• 统一接口：使用标准的CRUD接口
• Uri寻址：通过content://authority/path定位数据
• 权限控制：支持静态Manifest权限和动态Uri权限
• 进程隔离：Provider运行在独立进程。Binder IPC通信
• 数据观察：ContentObserver监听数据变化

四层架构概览

1. 客户端：通过ContentResolver发起CRUD操作
2. Framework：Ams管理Provider生命周期和权限检查
3. Provider进程：执行实际数据操作
4. 数据存储：
5. 通知机制：

主要组件分析

ContentResolver - 客户端代理

// frameworks/base/core/java/android/content/ContentResolver.java
public abstract class ContentResolver {
// 查询
public final Cursor query(Uri uri,String projection,String selection,String selectionArgs,String sortOrder) {
IContentProvider provider = acquireProvider;Cursor cursor = provider.query(mPackageName,uri。projection,selection,selectionArgs,sortOrder,null);return cursor;}
// 插入
public final Uri insert {
IContentProvider provider = acquireProvider;Uri result = provider.insert;notifyChange;return result;}
// 更新
public final int update(Uri uri,ContentValues values,String where。String selectionArgs) {
IContentProvider provider = acquireProvider;int count = provider.update(mPackageName。uri,values,where,selectionArgs);notifyChange;return count;按理说，}
// 删除
public final int delete(Uri url,String where。String selectionArgs) {
IContentProvider provider = acquireProvider;说起来，int count = provider.delete(mPackageName。url,where,selectionArgs);notifyChange;return count;}
}

ActivityManagerService - Provider管理器

User Pain Point: 首次访问某个 Provider 时如果该 Provider 所在进程尚未启动，会出现卡顿。了解 AMS 的延迟加载机制，对...有帮助定位并调整此类卡顿。

// frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java
public class ActivityManagerService extends IActivityManager.Stub {
private final ProviderMap mProviderMap = new ProviderMap;// 获取 ContentProvider
public ContentProviderHolder getContentProvider(
IApplicationThread caller,String callingPackage。String authority,int userId,boolean stable) {
synchronized {
ContentProviderRecord cpr = mProviderMap.getProviderByName;if {
// 已存在且进程存活
return cpr.newHolder;按理说，}
// 需要启动 Provider 进程
ProcessRecord proc = startProcessLocked(
cpi.processName。cpi.appInfo,"content provider",new ComponentName,userId);proc.thread.scheduleInstallProvider;synchronized {
while {
cpr.wait;// 等待 Provider 启动完成
}
}
return cpr.newHolder;}
}
// Provider 发布回调
public void publishContentProviders(IApplicationThread caller。List providers) {
synchronized {
for {
ContentProviderRecord dst = mProviderMap.getProviderByClass(
src.info.name,getUserIdFromUid);按理说，if {
dst.provider = src.provider;dst.proc = getRecordForAppLocked;synchronized { dst.notifyAll;}
}
}
}
}
}

生命周期要点：

• Lazily loaded: 首次访问才启动 Provider 进程。老实说，
• Singe‑instance per authority: 同一 authority 只会有一个实例。
• Tied to host process: Host 进程死亡时自动清理记录。
• AUTOCLEAN: 进程异常退出后 AMS 自动移除对应 Provider。其实，

二、ContentProvider 生命周期

启动流程onCreate 在 Application.onCreate 前执行导致循环依赖

// frameworks/base/core/java/android/app/ActivityThread.java
public final class ActivityThread extends ClientTransactionHandler {
// 应用启动时安装 Provider
private void handleBindApplication {
Application app = data.info.makeApplication;List providers = data.providers;if { installContentProviders;}
mInstrumentation.callApplicationOnCreate;// <-- 此后才是 Application.onCreate
    }
    private void installContentProviders(Context context,
                                          List providers) {
ArrayList results = new ArrayList<>;for {
ContentProvider local =
installProvider;IContentProvider provider = local.getIContentProvider;ContentProviderHolder cph = new ContentProviderHolder;cph.provider = provider;results.add，}
ActivityManager.getService.publishContentProviders;}
private ContentProvider installProvider(Context context,IContentProvider provider。ProviderInfo info,boolean noisy,boolean noReleaseNeeded) {
ClassLoader cl = context.getClassLoader;Content.Provider local =
cl.loadClass.newInstance;local.attachInfo;// 初始化 Context、Authority 等信息
local.onCreate;// *** 在 Application.onCreate 前调用 ***
return local;}
}

Pain Point: 如果在 YourApplication.onCreate 里直接调用自己的 Provider，会产生循环依赖或空指针异常。正确做法是把初始化逻辑放到 Provider 的 onCreate 中，或者延迟到第一次查询时再使用。

示例实现UriMatcher 未匹配导致 IllegalArgumentException

class ContactsProvider : Content.Provider {
private lateinit var dbHelper: DatabaseHelper
private lateinit var uriMatcher: UriMatcher
companion object {
const val AUTHORITY = "com.example.contacts"
val CONTENT_URI: Uri =
Uri.parse
const val CONTACTS = 1
const val CONTACT_ID = 2
}
override fun onCreate: Boolean {
dbHelper = DatabaseHelper
uriMatcher = UriMatcher.apply{
addURI
addURI
}
return true
}
override fun query(uri: Uri,projection: Array?怎么说呢，,selection: String?,selectionArgs: Array?不过，,sortOrder: String?): Cursor，{
val db = dbHelper.readableDatabase
val match = uriMatcher.match
Log.d // 调试帮助定位 Unknown URI
val cursor= when{
CONTACTS -> db.query("contacts"。projection,selection,selectionArgs,null,null,sortOrder)
CONTACT_ID ->{
val id=uri.lastPathSegment!，db.query,null,null。sortOrder)
}else -> throw IllegalArgumentException
}
cursor?.setNotificationUri
return cursor
}
/* insert / update / delete 同理省略 */
}

Manifest 声明忘记打开 grantUriPermissions 导致 Intent 授权失效

• a uthorities: 唯一标识符，建议使用完整包名。
• a xported: 是否对外可见。按理说，
• a readPermission/writePermission: 静态声明的全局权限。
• a grantUriPermissions: 必须开启，否则 FLAG_GRANT_READ_URI_PERMISSION 无效。

三、Uri 权限授予机制

设计理念——精细化授权取代粗粒度 Manifest 权限

Pain Point: "Permission Denial" 异常频繁出现。因为开发者仍然依赖 Manifest 权限，而不是利用 Uri 临时授权。

• Sparse Granularity： 针对单个 Uri 授权，而非整个 Provider。
• b e Temporary：Activity / Service 生命周期结束后自动撤销.
.
• b e No User Prompt：程序内部完成授权，不打扰使用者.
.
• b e Secure：不暴露底层文件方法.
. <\/ul\

主要实现 – UriGrantsManagerService

// frameworks/base/services/core/java/com/android/server/uri/UriGrantsManagerService .java public class UriGrantsManagerService extends IUriGrantsManager.Stub { // uid → GrantSet private final SparseArray mGrantedU​riPermissions= new SparseArray<>;void grantU​riPe rmission( int callingUid,String targetPkg。Ur i uri,int modeFlags,int targetUid){ enforceNotIsolatedCaller;GrantUri grant=new GrantUri,uri,…)，URI‑permission perm=findOrCrea teU riP ermissionLocked;perm.grantModes;怎么说呢，mGrantedUr iPe rmissions…​ } int checkU riPe rmission{ URI‑permi ssion perm=findUr iPerm issionLocked);ifreturn PackageManag er.PERMISSION_DENIED;return ==modeFlags)?PackageM anager.PERMISSION_GRANTED: PackageManag er.PERMISSION_DENIED;} void revokeUr iP erm ission{   …} } --- ### 常见授予场景 #### 场景1 – 通过 Intent 分享图片 kotlin fun shareImage{ val intent=Intent.apply{ type=“image/*” putExtra addFlags// 临时读授权 } startActivity) } // 接收方无需额外声明 READ_EXTERNAL_STORAGE，只能读取该 Uri 对应的数据 class ShareActivity : AppCompatActivity{ override fun onCreate{ super.onCreate val imageUri=intent.getParcelableExtra?，return val bmp=BitmapFactory.decodeStream) \timageView.setImageBitmap } } **关键流程**：框架检测 `FLAG_GRANT_READ_URI_PERMISSION` 并调用 `mUriGrantsManager.grant...` 把读权绑定到目标组件。#### 场景2 – PendingIntent 延迟授权 kotlin fun createNotificationWithImage{ val intent=Intent.apply{ \tdata=imageUri \taddFlags} val pending=PendingIntent.getActivity val note=NotificationCompat.Builder…\t .setContentIntent.build \tnotificationManager.notify} *优势*的观点是。点击通知时目标 Activity 自动获得读权，即使它在另一进程。#### 场景3 – 持久化 Uri 权限 kotlin fun takePersistablePermission{ try{ contentResolver.takePersistableUriPermission( uri,I ntent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION ) // 保存到 DB。以后可直接使用 }catch{Log.e}} fun releasePersistablePermission{ contentResolver.releasePersistableUr iPermission( uri,I ntent.FLAG_GRANT_READ_URI_PERMIS sion or Intent.FLAG_GRANT_WRITE_UR IPERMISSION)} // 列出已持久化的所有授权 fun listPersisted{ for{ Log.d }} **实现细节**：`grantMode` 被标记为 `persistedModeFlags` 并写入磁盘 XML，程序重启后仍然有效。#### 场景4 – 前缀匹配目录级别授权 kotlin val intent=Intent.apply{ data=directoryUri addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_PREFIX_URI_PERMISSION)} startActivity | 授权方法 | 匹配成功 | 匹配失败 | |---|---|---| | `content://com.example/files` | ✅ `…/files/image.jpg` | ❌ `…/or/data.txt` | --- ### **使用者痛点速查表** | 痛点 | 常见表现 | 推荐方法 | |------|----------|--------------| | **SecurityException – Permission Denial** | 调用 `query/insert` 报错 | 检查 Manifest 权限、使用 `FLAG_GRANT_*` 或持久化 | | **IllegalArgumentException – Unknown URI** | `uriMatcher.match` 返回 NO_MATCH | 确认 `addURI` 配置、打印匹配码调试 | | **Cursor 泄漏** | StrictMode 警告 “LeakedClosableViolation” | 使用 `use{}` 或手动 `close` | | **启动卡顿** | 首次访问大体积 Provider 时 UI 卡住 | 在后台提前预热或拆分为轻量子 Provider | --- ## 四、ContentObserver 数据观察

工作原理

kotlin class ContactsObserver: ContentObserver{ override fun onChange{ Log.d refreshData }} // 注册 fun observe{ val obs=ContactsObserver)) contentResolver.registerContentObserver( ContactsProvid er.CONTENT_URI。true,obs)} // 注销 fun unreg{ contentResolver.unregisterCo ntentObserver} ### 通知链路 java // frameworks/base/core/java/android/content/Conten tResolver.java public void notifyChange{ notifyChange;} public void notifyChange(Uri uri,ContentObserver observer。boolean syncToNetwork){ getCo ntentService.notifyChange(uri,observer==null?null : observer.getConte ntObse rver,observer!=null && observer.deliverSelfNoti fications。syncToNetwork,UserHandle.getCallingUserId);说起来，} // frameworks/base/services/core/jav a/com/android/server/content/C ontentService.java public void notifyChange(Uri uri。IConten tObse rver observer,boolean selfNotify,boolea n syncToNetwork,int userHandle){ synchronized{ ArrayList calls=new ArrayList<>;mRootNode.collectObserversLock ed;for{ try{call.mObserver.onChange(call.mSelfCha nge。uri,userHandle);}catch{} }}} 至于*树形结构*，content:// ← rootNode └─ com.example.contacts/ ├─ contacts/ ← Observer A │ ├─ / ← Observer B │ └─ groups/ ### 批量通知调整 kotlin class ContactsProvid er : Conten tProvi der{ private val batchMode=ThreadLocal override fun bulkInsert:Int{ batchMode.set db.beginTransaction try{ for{db.insert} db.setTransactionSuccessful }finally{ db.endTransaction batchMode.set } context?.contentResolver?其实，.notifyChange//一次性通知 return count} } --- ## 五、FileProvide r 文件共享 ### 为什么不能直接分享 file:// URI？* 暴露真实文件程序方法。* 需要 ``。* Android N 起抛出 `FileUriExposedException`。### FileProvid er 工作原理 * 将本地 `` 映射为 ``。* 使用临时 URI 权限，无需存储权限。* 完全兼容 Scoped Storage。#### Manifest 配置 xml ` #### 方法映射 xml ` #### 常用示例 **1️⃣ 分享 PDF** kotlin fun shareFile{ val uri=FileProvid er.getUr iForFile(this,"${applicationContext.packageName}.fileprovider",file ) val intent=Intent.apply{ type=\"application/pdf\" putExtra addFlags} startActivity)} **2️⃣ 拍照保存** kotlin fun takePicture{ val photoFile=File,\"photo_${System.currentTimeMillis}.jpg\") val photoUr i=FileProvider.getUriForFil e(this。\"${applicationContext.packageName}.fileprovider\",photoFile ) val intent=Intent.apply{ putExtra addFlags} startActivityForResult} **3️⃣ 安装 APK** kotlin fun installApk{ val apkUr i=if{ FileProvider.getU riForFile(this,\"${applicationContext.packageName}.fileprovider\",apkFile ) }else Uri.fromFil e val intent=Intent.apply{ setDataAndType addFlags addFla gs} startActivity} #### 实现细节摘录 java // androidx/core/content/FileProvider.java public static Uri getUr iForFil e{ PathStrategy s=getPathStrategy;retu rn s .getU riForFil e;} @Override public ParcelFi leDescriptor openF ile{ Fil e f=mStrategy.g etFileForUrl;int fm odeFlag=m o deToM ode;老实说，retu rn ParcelF ileDescriptor.open;} --- ## 六、调试与问题诊断 ### 常用 dumpsys 命令 bash # 查看已注册的所有 Provider adb shell dumpsys activity providers # 查看当前 UID 的 URI 授权记录 adb shell dumpsys activity permissions # 开启 ContentResolver 日志 adb shell setprop log.tag.ContentResolver VERBOSE && adb logcat -s ContentResolver ### 症状 & 排查表

Pain Point	Description Solution
SecurityException ： Permission Denial	调用方缺少 Manifest 权限或未获得临时 URI 权限	① 检查 `` 的 read/write permission；② 使用 Intent FLAG_ GRANT_*；③ 若需长期访问，请调用 `takePersistable…`，
IllegalArgumentException ： Unknown URI	`uriMatcher.match` 未匹配任何方法	确认 `addURI` 参数拼写；在代码中打印 matchCode 调试。
Cursor 窗口泄漏	未关闭 Cursor 导致 StrictMode 警告	使用 Kotlin 的 `.use{}` 或 Java 的 try‑with‑resources 自动关闭。怎么说呢，
启动卡顿	AMS 延迟加载 Provider 所致	可考虑提前预热 或拆分为轻量子模块。

--- ## 七、常用方法汇总 ### 📌 Provider 设计建议
• 异步查询： suspend fun loadContacts → 
• 批量写入：  → 
• 及时释放资源： 
• 最小化公开范围：  + 

📌 Uri 权限安全实践

• 如只需读取则只加 ``FLAG_GRANT_READ_URI_PERMISSION`\`。<\/ li> \
• 在 Activity.onDestroy 中遍历已授予列表并调用 `revokeUuidermission`\<\/CODE>\<\/ li \>\ \
• 检查 `uri.authority`\<\/CODE>\ 是否属于可信方。\<\/ li \>\<\/ ul \>\ ### 📌 Observer 使用技巧
  \
  • 在 onStart/onStop 中注册与注销，以免内存泄漏。\<\/ li \>\ \
  • 利用 Handler.postDelayed 实现批量刷新，避免短时间内大量回调。\<\/ li \>\ \
  \ --- ## 八、Android 15 新特性概览 ### 提高型 Uri 权限控制 java void grantUi dPe rmissionWithExpiry(int callingUid。String targetPkg,Uri u ri,int modeFla gs,int targetUid,long expiryMs ){ GrantU ri perm=findOrCr ate... perm.grantModes;perm.expiryTime=expiryMs;mHandler.postDelayed -> revokeExpiredPermissions,expiryMs-System.currentTimeMillis);} ### Photo Picker 集成 kotlin fun selectPhoto{ val intent＝Intent.apply{ type=”image/*” putExtra } startActi vityForResult} override fun onActiv ityResult{ if{ val clip=data?.clipData if{for{ val u=r=i.clipData!，老实说，.getItemAt.ur i loadImage}} else {data?.data，.let{loadImage}}}} ### 并行化 Provider 启动 java private void installCont entProviders{ ExecutorService exec= Executors.newFixedThreadPool,Runtime.ge tRuntime.availableProcessors));不过，List futures=new ArrayL ist<>;for{ futures.add ->installProvider));} for results.add));exec.shutdown;ActivityM anager.ge tServic e.publishCon tentProviders;怎么说呢，} --- ## 九、——主要要点回顾 1. **四层架构 + 生命周期管理**：Client → Framework → Provider Process → Storage。老实说，`onCreate` 在 Application 前执行。需要注意循环依赖，话说回来，2. **精细化 Uri 权限**：临时授权 、持久化 、前缀匹配还有 Android 15 的过期控制。3. **FileProv ide 替代裸文件方法**：安全、高效且符合 Scoped Storage。怎么说呢，4. **Observer 通知树形结构 + 批量调整**：避免 UI 高频刷新。5. **常用方法**：异步查询、批量写入、最小化公开范围、及时撤销临时授权、防抖 Observer 注册。### 与程序其他子模块协同工作
  • Ams : 
  • PMS : Binder :&n bsp;SElinux :&n bsp;

  ---

  #