企业官网建设流程全解析

1. 理解/system/product/priv-app目录的特殊性

在Android系统中，/system/product/priv-app目录是一个具有特殊权限的应用存放位置。与普通的/system/app目录不同，这里的应用会被自动授予PRIVILEGED权限，这意味着它们可以访问普通应用无法获取的系统级API和权限。这个目录通常用于存放设备制造商预装的核心应用，如系统设置、拨号器等关键组件。

priv-app目录下的APK需要满足几个关键条件：

• 必须包含privileged权限声明
• 需要正确的签名（通常使用平台签名）
• 必须包含在系统的白名单中

注意：从Android 10开始，Google加强了分区限制，/system分区变为只读。因此现代方案更多使用动态分区如/product分区来存放这类预装应用。

2. 预装APK的准备工作

2.1 APK的权限配置

要使APK能够预装到priv-app目录，首先需要在AndroidManifest.xml中添加特权声明：

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.myapp"> <!-- 关键声明 --> <privileged-permission android:name="android.permission.CONTROL_DEVICE"/> <!-- 其他配置 --> ... </manifest>

2.2 签名要求

priv-app下的APK必须使用平台签名密钥签名。通常这是由设备制造商持有的密钥。开发阶段可以使用测试密钥：

# 使用AOSP测试密钥签名 java -jar signapk.jar platform.x509.pem platform.pk8 app-debug.apk app-signed.apk

2.3 白名单配置

在AOSP源码中，需要将应用包名添加到/etc/permissions/privapp-permissions-[device].xml：

<permissions> <privapp-permissions package="com.example.myapp"> <permission name="android.permission.CONTROL_DEVICE"/> </privapp-permissions> </permissions>

3. 使用Android.bp构建系统集成

3.1 创建Android.bp文件

在AOSP源码树中，为你的APK创建构建定义文件：

android_app { name: "MyPrivApp", srcs: ["src/**/*.java"], resource_dirs: ["res"], // 关键配置 privileged: true, product_specific: true, certificate: "platform", static_libs: ["androidx.appcompat_appcompat"], manifest: "AndroidManifest.xml", }

3.2 产品特定配置

在设备的产品定义文件（如device/[vendor]/[device]/[product].mk）中添加：

PRODUCT_PACKAGES += MyPrivApp PRODUCT_PRIVILEGED_MODULES += MyPrivApp

3.3 目录结构规范

APK在源码树中的推荐存放位置：

vendor/[vendor]/[device]/prebuilts/priv-app/MyPrivApp/ ├── Android.bp ├── AndroidManifest.xml ├── res/ └── src/

4. 手动部署方案（无需编译整个系统）

4.1 准备工作

1. 获取已签名的APK文件
2. 确保设备已解锁bootloader
3. 获取root权限（临时或永久）

4.2 部署步骤

# 重新挂载/system为可读写 adb root adb remount # 推送APK到目标目录 adb push MyPrivApp.apk /system/product/priv-app/MyPrivApp/ # 创建必要的目录结构 adb shell "mkdir -p /system/product/priv-app/MyPrivApp/oat/arm64" # 设置正确权限 adb shell "chmod 755 /system/product/priv-app/MyPrivApp" adb shell "chmod 644 /system/product/priv-app/MyPrivApp/MyPrivApp.apk" # 重启设备 adb reboot

4.3 验证安装

设备重启后检查：

adb shell pm list packages | grep myapp adb shell dumpsys package com.example.myapp | grep flags

应看到flags=PRIVILEGED的标记。

5. 常见问题排查

5.1 应用未出现在应用列表中

可能原因：

• 签名不匹配（必须使用平台签名）
• 缺少privapp-permissions配置
• SELinux策略限制

检查日志：

adb logcat | grep -E 'PackageManager|MyPrivApp'

5.2 权限被拒绝

典型错误：

java.lang.SecurityException: Package com.example.myapp has not requested permission android.permission.CONTROL_DEVICE

解决方案：

1. 确认APK的AndroidManifest.xml已声明权限
2. 检查privapp-permissions.xml是否包含该权限授权
3. 验证APK是否确实安装到了priv-app目录

5.3 系统升级后应用消失

这是因为/system分区在OTA升级时会被完全覆盖。持久化方案：

1. 将APK放入/product分区（如果设备支持）
2. 使用动态分区方案
3. 创建刷机脚本在升级后自动恢复

6. 高级技巧与优化

6.1 多架构支持

对于包含native库的APK，需要处理多ABI支持：

android_app { name: "MyPrivApp", // ...其他配置 compile_multilib: "both", native_shared_libs: ["mynative"], }

6.2 资源覆盖机制

priv-app可以覆盖系统默认资源，在APK的res/values/中定义：

<!-- 覆盖系统默认主题 --> <style name="Theme.DeviceDefault" parent="@android:style/Theme.DeviceDefault"> <item name="android:colorPrimary">@color/my_primary</item> </style>

6.3 版本兼容处理

在Android.bp中使用特定版本配置：

target: { android: { min_sdk_version: "29", max_sdk_version: "33", }, },

7. 替代方案比较

7.1 不同预装目录对比

7.2 动态加载方案

对于需要频繁更新的特权应用，可以考虑：

1. 将核心功能拆分为特权APK+普通APK
2. 特权APK只提供权限代理
3. 业务逻辑放在可动态更新的普通APK中

实现示例：

// 在特权APK中 public class PermissionProxy extends Binder { @Override protected boolean onTransact(int code, Parcel data, Parcel reply, int flags) { verifyCallingPackage("com.example.myapp.normal"); // 执行特权操作 } }

8. 安全最佳实践

1. 最小权限原则：只请求必要的privileged权限
2. 签名保护：严格保管平台签名密钥
3. 输入验证：对所有跨进程调用进行验证
4. 定期审计：检查privapp-permissions配置
5. 隔离设计：将特权组件与非特权组件分离

审计脚本示例：

# 检查所有特权应用的权限使用情况 adb shell "pm list packages -f -U | grep priv-app" | while read line; do pkg=${line##*=} echo "=== $pkg ===" adb shell "dumpsys package $pkg | grep -A 10 'requested permissions'" done

9. 实际案例：预装系统设置插件

假设我们要预装一个自定义的系统设置插件：

1. 创建Android.bp：

android_app { name: "CustomSettings", srcs: ["src/**/*.java"], resource_dirs: ["res"], manifest: "AndroidManifest.xml", privileged: true, product_specific: true, certificate: "platform", static_libs: [ "androidx.preference_preference", "SettingsLib" ], }

2. 在系统设置中添加入口：

<!-- in res/xml/settings_headers.xml --> <header android:id="@+id/custom_settings" android:title="@string/custom_settings_title" android:fragment="com.example.customsettings.CustomFragment" />

3. 添加权限配置：

<!-- etc/permissions/privapp-permissions-device.xml --> <privapp-permissions package="com.example.customsettings"> <permission name="android.permission.WRITE_SECURE_SETTINGS"/> <permission name="android.permission.CONTROL_DEVICE"/> </privapp-permissions>

10. 调试技巧

10.1 日志过滤

专用logcat过滤器：

adb logcat -v threadtime -s CustomSettings:I \ ActivityManager:I PackageManager:I *:S

10.2 运行时检查

验证特权状态：

public boolean isPrivileged() { try { ApplicationInfo ai = getPackageManager() .getApplicationInfo(getPackageName(), 0); return (ai.privateFlags & ApplicationInfo.PRIVATE_FLAG_PRIVILEGED) != 0; } catch (PackageManager.NameNotFoundException e) { return false; } }

10.3 资源覆盖调试

检查当前资源值：

adb shell "cmd overlay list" adb shell "cmd overlay dump <package>"

11. 性能优化建议

1. 延迟加载：将非关键初始化放在后台线程
2. 模块化设计：使用动态功能模块(DFM)
3. 资源优化：使用WebP格式图片，压缩资源
4. ProGuard规则：确保核心代码不被混淆

示例ProGuard配置：

-keep class com.example.myapp.** { *; } -keepclassmembers class * extends android.app.Service { public *; }

12. 兼容性处理

12.1 多版本适配

在Android.bp中使用条件编译：

target: { android: { cflags: [ "-DANDROID_VERSION=" + ctx.config().get("Platform_sdk_version"), ], }, },

12.2 备用方案

当特权功能不可用时提供降级方案：

public void performPrivilegedAction() { try { // 尝试特权API SystemProperties.set("custom.property", "value"); } catch (SecurityException e) { // 降级处理 SharedPreferences prefs = getSharedPreferences("fallback", MODE_PRIVATE); prefs.edit().putString("property", "value").apply(); } }

13. 测试验证方案

13.1 单元测试

特权应用的特殊测试配置：

android_test { name: "MyPrivAppTests", srcs: ["test/**/*.java"], test_suites: ["general-tests"], test_config: "AndroidTest.xml", privileged: true, }

13.2 自动化测试

使用uiautomator测试特权功能：

@RunWith(AndroidJUnit4.class) public class PrivilegedTest { @Test public void testSystemPropertyAccess() { UiDevice device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation()); device.executeShellCommand("setprop debug.myapp 1"); // 验证特权操作 } }

14. 版本更新策略

14.1 无缝更新方案

1. 保留数据目录结构：

/system/product/priv-app/MyPrivApp/ ├── apk/ │ └── MyPrivApp.apk # 实际APK └── lib/ # Native库

2. 使用符号链接：

ln -sf /system/product/priv-app/MyPrivApp/apk/MyPrivApp.apk /system/product/priv-app/MyPrivApp.apk

14.2 A/B更新支持

在Android.bp中启用：

android_app { name: "MyPrivApp", // ...其他配置 use_vendor: true, overrides: ["other_priv_app"], }

15. 厂商定制扩展

15.1 设备特定功能

通过系统属性交互：

public class DeviceSpecificUtils { public static void enableFeature(boolean enable) { SystemProperties.set("vendor.myapp.feature.enable", enable ? "1" : "0"); } }

15.2 硬件抽象层集成

JNI层示例：

// native-lib.cpp extern "C" JNIEXPORT void JNICALL Java_com_example_myapp_DeviceController_setHardwareMode( JNIEnv* env, jobject obj, jint mode) { vendor::hardware::control::V1_0::IControl::getService() ->setMode(static_cast<int32_t>(mode)); }

16. 性能监控与调优

16.1 启动时间优化

测量应用启动时间：

adb shell am start-activity -W -n com.example.myapp/.MainActivity

16.2 内存分析

获取内存快照：

adb shell dumpsys meminfo com.example.myapp

16.3 电池消耗监控

检查唤醒锁：

adb shell dumpsys power | grep -i wake

17. 用户数据管理

17.1 数据迁移方案

处理系统升级时的数据保留：

public class DataMigrationHelper { public static void migrateIfNeeded(Context context) { SharedPreferences oldPrefs = context.getSharedPreferences( "prefs", Context.MODE_PRIVATE); if (!oldPrefs.getBoolean("migrated", false)) { // 执行迁移 ContentResolver resolver = context.getContentResolver(); // ...迁移逻辑 oldPrefs.edit().putBoolean("migrated", true).apply(); } } }

17.2 备份恢复策略

实现自动备份：

<!-- AndroidManifest.xml --> <application android:allowBackup="true" android:fullBackupContent="@xml/backup_rules"> ... </application>

18. 多用户支持

18.1 用户感知处理

检查当前用户类型：

UserManager um = (UserManager) context.getSystemService(Context.USER_SERVICE); if (um.isSystemUser()) { // 系统用户特有逻辑 }

18.2 跨用户数据共享

使用ContentProvider跨用户共享：

// 在Manifest中声明 <provider android:name=".MyProvider" android:authorities="com.example.myapp.provider" android:exported="true" android:multiprocess="true" android:process=":provider" />

19. 安全更新策略

19.1 热修复方案

通过特权应用加载补丁：

public class PatchLoader { public static void loadPatch(Context context, File patch) { try { DexClassLoader loader = new DexClassLoader( patch.getAbsolutePath(), context.getCodeCacheDir().getAbsolutePath(), null, context.getClassLoader()); Class<?> clazz = loader.loadClass("com.example.patch.Fix"); // 应用补丁 } catch (Exception e) { Log.e("Patch", "Failed to load patch", e); } } }

19.2 证书轮换机制

处理签名证书变更：

private boolean verifySignature(Context context) { PackageManager pm = context.getPackageManager(); PackageInfo info = pm.getPackageInfo(context.getPackageName(), PackageManager.GET_SIGNATURES); Signature[] sigs = info.signatures; // 验证签名是否在允许列表中 }

20. 厂商协作建议

1. 接口标准化：定义清晰的API边界
2. 兼容性测试套件：提供CTS扩展测试
3. 文档规范：详细记录特权接口
4. 版本协商：建立版本兼容矩阵
5. 安全评审：定期进行代码审计

厂商接口示例：

/** * @hide * @vendor */ public interface IVendorFeature { /** 需要权限: vendor.permission.FEATURE_CONTROL */ void enableFeature(String feature, boolean enable); }