Android系统媒体预置方案设计与实现-代码聚汇网

Android系统媒体预置方案设计与实现

小鹅通

1. Android 16 媒体预置方案设计背景

在智能设备出厂预装场景中，媒体素材的预置一直是个看似简单实则暗藏玄机的需求。想象一下这样的场景：用户拆开新手机包装，开机后相册里已经内置了精美的壁纸合集，图库中预装了产品宣传视频，音乐应用里自带几首高品质演示曲目——这些看似简单的"开箱即用"体验，背后需要一套可靠的自动化机制支撑。

传统做法往往存在三个痛点：

时机问题：过早执行会导致外部存储未挂载，过晚执行又影响用户体验
权限问题：系统服务访问用户目录需要精细的权限控制
幂等问题：重复执行不能导致资源浪费或文件冲突

我们团队在Android 16定制开发中，设计了一套基于SystemUI启动链的媒体预置方案。这个方案最巧妙的地方在于利用了CoreStartable这个SystemUI特有的生命周期钩子，既保证了执行的正确时机，又无需额外增加系统服务。

关键设计原则：最小侵入性。整个方案只新增2个Java类，修改3处现有代码，却实现了完整的媒体预置功能链。

2. 方案架构详解

2.1 三层架构设计

2.1.1 构建层（Build Layer）

这是整个流程的起点。我们需要在编译阶段就将媒体资源打包进系统镜像，这里有几个技术细节需要注意：

资源目录结构必须与目标用户目录保持一致
文件权限需要预先设定为0644（-rw-r--r--）
必须使用PRODUCT_COPY_FILES而非简单拷贝

典型的构建脚本修改如下：

makefile复制# 在device/<vendor>/<product>/device.mk中添加
EXT_MEDIA_PATH := vendor/<vendor>/extMedia
PRODUCT_COPY_FILES += \
    $(call find-copy-subdir-files,*,$(EXT_MEDIA_PATH),system/extMedia)

这个脚本片段实现了：

递归拷贝extMedia/目录下所有文件
保留原始目录结构
将文件部署到/system/extMedia系统分区

2.1.2 启动层（Bootstrap Layer）

这是方案最核心的创新点。我们选择SystemUI作为切入点是因为：

SystemUI具有系统级权限
它的启动时机恰好在外部存储挂载之后
通过CoreStartable可以无缝集成到现有启动流程

关键类MediaPreloadStartable的实现要点：

java复制@Singleton
public class MediaPreloadStartable implements CoreStartable {
    private final Context mContext;
    private final MediaPreloadHelper mHelper;

    @Inject
    public MediaPreloadStartable(Context context, MediaPreloadHelper helper) {
        mContext = context;
        mHelper = helper;
    }

    @Override
    public void start() {
        IntentFilter filter = new IntentFilter();
        filter.addAction(Intent.ACTION_BOOT_COMPLETED);
        mContext.registerReceiver(new BroadcastReceiver() {
            @Override
            public void onReceive(Context context, Intent intent) {
                if (Intent.ACTION_BOOT_COMPLETED.equals(intent.getAction())) {
                    mHelper.preloadMedia();
                }
            }
        }, filter);
    }
}

2.1.3 执行层（Execution Layer）

MediaPreloadHelper负责实际的拷贝操作，其设计考量包括：

必须后台线程执行（避免阻塞主线程）
需要处理文件冲突（同名文件跳过）
必须记录执行状态（SharedPreferences实现幂等）

2.2 关键实现细节

2.2.1 Dagger注入配置

在SystemUI的依赖注入体系中注册我们的组件：

java复制@Module
public abstract class MediaPreloadModule {
    @Binds
    @IntoMap
    @ClassKey(MediaPreloadStartable.class)
    public abstract CoreStartable bindMediaPreloadStartable(
        MediaPreloadStartable impl);
}

2.2.2 文件拷贝算法

递归拷贝的核心逻辑需要注意：

源路径：/system/extMedia
目标路径：/sdcard/Android/media
使用FileUtils.copy()而非普通IO流
维护已拷贝文件清单

java复制public void preloadMedia() {
    Executors.newSingleThreadExecutor().execute(() -> {
        SharedPreferences prefs = mContext.getSharedPreferences("media_preload", MODE_PRIVATE);
        if (prefs.getBoolean("completed", false)) {
            return; // 幂等控制
        }

        File source = new File("/system/extMedia");
        File target = Environment.getExternalStorageDirectory();
        
        try {
            copyDirectory(source, target);
            prefs.edit().putBoolean("completed", true).apply();
        } catch (IOException e) {
            Log.e(TAG, "Media preload failed", e);
        }
    });
}

3. 实战问题与解决方案

3.1 SELinux权限问题

首次测试时遇到SELinux拒绝访问的错误。解决方案：

在file_contexts中添加：

code复制/system/extMedia(/.*)? u:object_r:system_file:s0

在te文件中添加：

code复制allow system_app sdcardfs:dir { create search write };

3.2 大文件拷贝优化

当预置视频文件较大时（>100MB），直接拷贝可能导致ANR。改进措施：

分块拷贝（每次1MB）
增加进度通知
允许后台继续

java复制private void copyFile(File src, File dst) throws IOException {
    try (InputStream in = new BufferedInputStream(new FileInputStream(src));
         OutputStream out = new BufferedOutputStream(new FileOutputStream(dst))) {
        byte[] buffer = new byte[1024 * 1024]; // 1MB buffer
        int length;
        while ((length = in.read(buffer)) > 0) {
            out.write(buffer, 0, length);
            // 这里可以添加进度回调
        }
    }
}

3.3 多用户支持

Android支持多用户后，需要为每个用户执行拷贝：

java复制UserManager um = mContext.getSystemService(UserManager.class);
for (UserInfo user : um.getUsers()) {
    File userTarget = Environment.getExternalStorageDirectoryForUser(user.id);
    copyDirectory(source, userTarget);
}

4. 性能优化实践

4.1 延迟加载策略

通过分析启动性能数据，我们发现可以在BOOT_COMPLETED后再延迟10秒执行：

java复制mHandler.postDelayed(() -> mHelper.preloadMedia(), 10_000);

4.2 资源选择性加载

在extMedia目录下增加.metadata文件，标记文件优先级：

code复制wallpapers/highres=urgent
samples/video=background

4.3 内存优化

大文件拷贝时主动释放内存：

java复制void copyLargeFile() {
    System.gc();
    // 拷贝逻辑
}

5. 测试验证方案

5.1 单元测试要点

模拟/system/extMedia目录结构
验证SharedPreferences标记
测试文件冲突处理

java复制@Test
public void testPreloadTwice() {
    helper.preloadMedia();
    helper.preloadMedia(); // 第二次应该跳过
    verify(prefs, times(1)).edit();
}

5.2 集成测试场景

冷启动测试
存储空间不足场景
权限变更测试

5.3 性能测试指标

启动时间影响（应<50ms）
内存占用峰值（应<10MB）
存储IO负载

6. 扩展应用场景

这套方案不仅适用于媒体文件，还可以用于：

预置文档模板（Word/Excel）
初始化应用缓存数据
部署机器学习模型文件

只需要修改MediaPreloadHelper中的目标路径和文件过滤逻辑即可。

我在实际项目中还遇到过几个值得分享的细节问题：当预置文件数量超过1000个时，简单的递归拷贝会导致栈溢出。后来我们改用基于队列的广度优先遍历算法解决了这个问题。另外发现某些厂商定制ROM会修改外部存储路径，因此需要增加路径兼容性检查：

java复制File[] extDirs = ContextCompat.getExternalFilesDirs(mContext, null);
if (extDirs.length > 0) {
    target = extDirs[0].getParentFile();
}

这些经验都是在真实项目中踩坑后总结出来的，希望能帮到正在实现类似功能的开发者。