Android Framework 添加新的系统服务

最新推荐文章于 2024-05-10 14:53:40 发布

Android学习小分队

最新推荐文章于 2024-05-10 14:53:40 发布

阅读量631

点赞数

分类专栏： framework 文章标签： android

本文链接：https://blog.csdn.net/m0_56144365/article/details/128703573

版权

framework 专栏收录该内容

8 篇文章 0 订阅

订阅专栏

基于上一篇对 AMS 的类图结构的学习，
AMS 类图结构
想自己添加一个新的系统服务，看看是否能实现，加深理解及学以致用。于是有了下文。
开发环境：

Android SDK 31 (Android12 平台)
Android Studio version 2020.3.1
Gradle 依赖 6.8.3

一、总体涉及修改的文件：

1. 新增的服务

(1) 服务AIDL文件，定义服务的接口：
frameworks/base/core/java/android/app/IDemoManager.aidl
(2) 服务管理类，提供给客户端调用，以访问服务端的接口 (即持有服务端的引用， Binder 引用)
frameworks/base/core/java/android/app/DemoManager.java
(3) 服务实现类，实现AIDL 文件
frameworks/base/services/core/java/com/android/server/DemoManagerService.java

2. 创建及启动服务涉及的修改

(1) 定义服务的标识
frameworks/base/core/java/android/content/Context.java
(2) 创建及启动服务
frameworks/base/services/java/com/android/server/SystemServer.java
(3)创建服务管理类(可同时获取服务端的代理对象，由服务管理对象持有)
frameworks/base/core/java/android/app/SystemServiceRegistry.java

3. SELinux sepolicy 的权限修改

device/qcom/sepolicy/…/service.te
device/qcom/sepolicy/…/service_contexts *备注：其中路径中的 …
表示可能不同厂商的实际路径不一致，参考项目的目录配置

4. 其它平台限制的修改

根据异常log分析，添加对应修改即可，例如 ServiceManager.addService可能还有其它限制，如白名单service等

二、具体过程

1. 新增服务

1.1 服务AIDL文件：IDemoManager.aidl ，定义接口
方便起见，我们是添加在 android.app 包中（平台可能会限制我们添加到自定义的目录）
这里仅声明了一个 plus 函数，实现对两个 int 值的加法，并返回 int 值的结果，相当简单

// IDemoManager.aidl
package android.app;

// Declare any non-default types here with import statements

interface IDemoManager {
    int plus(int a, int b);
}

1.2 服务管理类： DemoManager.java
这里是参考 ActivityManager 源码的实现，获取服务的代理对象(Binder引用) 时，使用了单例模式；
Context.DEMO_SERVICE 是新增服务的标识，见下面的 Context.java 的修改；
提供两个方法，静态方法 plus 和非静态方法 plusA, 最终调用的都是服务端的 plus 方法；

package android.app;

import android.annotation.SystemService;

import android.content.Context;
import android.compat.annotation.UnsupportedAppUsage;
import android.os.IBinder;
import android.os.RemoteException;
import android.os.ServiceManager;
import android.util.Log;
import android.util.Singleton;

@SystemService(Context.DEMO_SERVICE)
public class DemoManager {
    private static String TAG = "DemoManager";

    /**
     * @hide
     */
    @UnsupportedAppUsage
    public static IDemoManager getService() {
        return IDemoManagerSingleton.get();
    }

    @UnsupportedAppUsage
    private static final Singleton<IDemoManager> IDemoManagerSingleton =
            new Singleton<IDemoManager>() {
                @Override
                protected IDemoManager create() {
                    final IBinder b = ServiceManager.getService(Context.DEMO_SERVICE);
                    final IDemoManager am = IDemoManager.Stub.asInterface(b);
                    return am;
                }
            };

    public static int plus(int a, int b) throws RemoteException {
        Log.d(TAG, "plus");
        return getService().plus(a, b);
    }

    public int plusA(int a, int b) throws RemoteException {
        Log.d(TAG, "plusA");
        return getService().plus(a, b);
    }


    /**
     * @hide
     */
    public DemoManager() {
    }
}

1.3 服务实现类： DemoManagerService.java
继承IDemoManager.Stub，实现接口；
内部静态类 Lifecycle 继承了 SystemService, 则可由系统管理它的生命周期 (启动、添加到SericeManager等); (不熟悉的可以看 SystemServie 的源码)
Context.DEMO_SERVICE 是新增服务的标识，见下面的 Context.java 的修改

package com.android.server;

import android.app.IDemoManager;
import android.content.Context;
import android.os.RemoteException;
import android.util.Log;

import com.android.server.SystemService;

import androidx.annotation.NonNull;

public class DemoManagerService extends IDemoManager.Stub{
    private static String TAG = "DemoManagerService";

    @Override
    public int plus(int a, int b) throws RemoteException {
        Log.d(TAG, "plus - a=" + a + ", b=" + b);
        return a + b;
    }

    public static final class Lifecycle extends SystemService {
        private final DemoManagerService mService;

        public Lifecycle(Context context) {
            super(context);
            mService = new DemoManagerService();
            Log.d(TAG, "Lifecycle create");
        }

        @Override
        public void onStart() {
            Log.d(TAG, "Lifecycle onStart start");
            publishBinderService(Context.DEMO_SERVICE, mService);
            Log.d(TAG, "Lifecycle onStart continue");
            mService.start();
            Log.d(TAG, "Lifecycle onStart end");
        }

        @Override
        public void onBootPhase(int phase) {

        }

//        @Override
//        public void onUserStopped(@NonNull TargetUser user) {
//        }

        public DemoManagerService getService() {
            return mService;
        }
    }

    private void start() {
        //todo
    }
}

2. 创建及启动服务

2.1 Context.java
定义服务的唯一标识

public static final String DEMO_SERVICE = "demo";

2.2 SystemServer.java
在startOtherServices() 方法中，启动服务
务必加上 try-catch, 否则，一旦发生异常，例如SEPolicy限制添加该 service而抛出 SecurityException, 则会导致 system_server进程挂掉，设备无法开机!!!

private void startOtherServices(@NonNull TimingsTraceAndSlog t) {
        // 省略一万行
        t.traceBegin("StartDemoManagerService");
        try {
            mSystemServiceManager.startService(DemoManagerService.Lifecycle.class);
        } catch (Throwable e) {
            reportWtf("starting DemoManagerService", e);
        }
        t.traceEnd();

2.3 SystemServiceRegistry.java
在静态代码块中，新增代码注册服务管理类对象

@SystemApi
public final class SystemServiceRegistry {
    // 省略一万行
    static {
       // 省略一万行
       registerService(Context.DEMO_SERVICE, DemoManager.class,
                new CachedServiceFetcher<DemoManager>() {
            @Override
            public DemoManager createService(ContextImpl ctx) {
                return new DemoManager();
            }});

3.SEPolicy 权限修改

SEPolicy 简单可以理解为 Linux 为了控制系统服务的访问权限，
ServiceManager 仅能访问特定类型的服务，因此新增的服务必须声明为对应的类型!!!
例如在上面修改的基础上，运行不起效，日志提示以下错误信息：

audit:                      avc:  denied  { add } for pid=1222 uid=1000 name=demo scontext=u:r:system_server:s0 tcontext=u:object_r:default_android_service:s0 tclass=service_manager permissive=0
即不允许 在 system_server 中， 通过 service_manager 获取到 服务demo(它的类型为: u:object_r:default_android_service:s0)

则，需要进行以下的修改
3.1 service.te 新增服务类型
在该文件后面新增：

type demo_service,         system_api_service, system_server_service, service_manager_type;

这里定义服务类型，服务名最好对应新增服务的标识(Context.java —> DEMO_SERVICE = “demo”)，
因此这里我们定义了：
服务名：demo_service
类型：system_api_service, system_server_service, service_manager_type
3.2 service_contexts 设置服务上下文类型
在该文件后面新增：

demo                  u:object_r:demo_service:s0

这里为新增的服务demo 设置类型为： u:object_r:demo_service:s0，
需要特别注意的是， demo 是对应Context.java 新增的：

public static final String DEMO_SERVICE = "demo";

demo_service 为在 service.te 定义的类型，必须一一对应，否则无效!!!
则可以得出结论： ServiceManager 访问的类型，必须是在 service.te 里定义的类型

4.其它修改

一般是与平台限制有关，
如ServiceManager addService 时提示仅允许白名单的service, 按提示加入白名单即可

又例如在 DemoManager 获取 service (即使用ServiceManager getService)时报错：

15:41:46.698  4689   4689   DemoManager:             plusA
15:41:46.705  696    795    audit:                   avc:  denied  { find } for pid=4689 uid=10320 name=demo scontext=u:r:untrusted_app:s0:c64,c257,c512,c768 tcontext=u:object_r:demo_service:s0 tclass=service_manager permissive=0
15:41:46.705  696    795    servicemanager:          demo : getService has failed, permission denied.

此时可尝试在 untrusted_app.te 中添加：

allow untrusted_app demo_service:service_manager find;

大概意识是，允许untrusted_app 通过 service_manager 获取到我们新增的服务 demo_service
( demo_service是我们在service.te 新增的服务类型)

5. 客户端使用

只需根据 Context.getSystemService 获取到 DemoManager，然后调用对应plusA 方法即可

import android.app.DemoManager;

.....
    private DemoManager mDemoManager;
     
    mDemoManager = (DemoManager) mContext.getSystemService(Context.DEMO_SERVICE);
    Log.d(TAG, " mDemoManager="+mDemoManager);
    if (mDemoManager != null ) {
        try {
            int result = mDemoManager.plusA(2,3);
            Log.d(TAG, "result="+result);
        } catch(Exception e) {
            e.printStackTrace();
        }
    }

服务创建、启动即使用日志打印：

03-31 06:11:43.985  1243  1243 I SystemServerTiming: StartDemoManagerService
03-31 06:11:43.985  1243  1243 I SystemServiceManager: Starting com.android.server.DemoManagerService$Lifecycle
03-31 06:11:43.987  1243  1243 D DemoManagerService: Lifecycle create
03-31 06:11:43.987  1243  1243 D DemoManagerService: Lifecycle onStart start

03-31 06:11:43.988   696   795 I servicemanager: Adding 'u:r:system_server:s0' service (demo:1243)

03-31 06:11:43.988  1243  1243 D DemoManagerService: Lifecycle onStart continue
03-31 06:11:43.988  1243  1243 D DemoManagerService: Lifecycle onStart end
03-31 06:11:43.988  1243  1243 D SystemServerTiming: StartDemoManagerService took to complete: 3ms

14:15:08.034  10415  10415  SampleApp mDemoManager=android.app.DemoManager@e8bd8a2
14:15:08.038  10415  10415  SampleApp  result=5

三、遇到的问题

SEPolicy 权限问题详细log：

16:37:47.140  1222   1222   SystemServerTiming:         StartDemoManagerService
16:37:47.140  1222   1222   SystemServiceManager:       Starting com.android.server.DemoManagerService$Lifecycle
16:37:47.142  1222   1222   DemoManagerService:         Lifecycle create
16:37:47.142  1222   1222   DemoManagerService:         Lifecycle onStart start
16:37:47.143  695    706    audit:                      avc:  denied  { add } for pid=1222 uid=1000 name=demo scontext=u:r:system_server:s0 tcontext=u:object_r:default_android_service:s0 tclass=service_manager permissive=0
16:37:47.144  1222   1222   SystemServer:               ***********************************************
16:37:47.146  1222   1222   SystemServer:               BOOT FAILURE starting DemoManagerService
16:37:47.146  1222   1222   SystemServer:               java.lang.RuntimeException: Failed to start service com.android.server.DemoManagerService$Lifecycle: onStart threw an exception
16:37:47.146  1222   1222   SystemServer:               at com.android.server.SystemServiceManager.startService(SystemServiceManager.java:244)
16:37:47.146  1222   1222   SystemServer:               at com.android.server.SystemServiceManager.startService(SystemServiceManager.java:225)
16:37:47.146  1222   1222   SystemServer:               at com.android.server.SystemServer.startOtherServices(SystemServer.java:2928)
16:37:47.146  1222   1222   SystemServer:               at com.android.server.SystemServer.run(SystemServer.java:1225)
16:37:47.146  1222   1222   SystemServer:               at com.android.server.SystemServer.main(SystemServer.java:946)
16:37:47.146  1222   1222   SystemServer:               at java.lang.reflect.Method.invoke(Native Method)
16:37:47.146  1222   1222   SystemServer:               at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:567)
16:37:47.146  1222   1222   SystemServer:               at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1113)
16:37:47.146  1222   1222   SystemServer:               Caused by: java.lang.SecurityException:
16:37:47.146  1222   1222   SystemServer:               at android.os.Parcel.createExceptionOrNull(Parcel.java:2437)
16:37:47.146  1222   1222   SystemServer:               at android.os.Parcel.createException(Parcel.java:2421)
16:37:47.146  1222   1222   SystemServer:               at android.os.Parcel.readException(Parcel.java:2404)
16:37:47.146  1222   1222   SystemServer:               at android.os.Parcel.readException(Parcel.java:2346)
16:37:47.146  1222   1222   SystemServer:               at android.os.IServiceManager$Stub$Proxy.addService(IServiceManager.java:452)
16:37:47.146  1222   1222   SystemServer:               at android.os.ServiceManagerProxy.addService(ServiceManagerNative.java:72)
16:37:47.146  1222   1222   SystemServer:               at android.os.ServiceManager.addService(ServiceManager.java:249)
16:37:47.146  1222   1222   SystemServer:               at com.android.server.SystemService.publishBinderService(SystemService.java:442)
16:37:47.146  1222   1222   SystemServer:               at com.android.server.SystemService.publishBinderService(SystemService.java:426)
16:37:47.146  1222   1222   SystemServer:               at com.android.server.SystemService.publishBinderService(SystemService.java:413)
16:37:47.146  1222   1222   SystemServer:               at com.android.server.DemoManagerService$Lifecycle.onStart(DemoManagerService.java:33)
16:37:47.146  1222   1222   SystemServer:               at com.android.server.SystemServiceManager.startService(SystemServiceManager.java:238)
16:37:47.146  1222   1222   SystemServer:               ... 7 more
16:37:47.143  0      0      [0:                         Binder:695_2:  706]  avc: denied  { add } for pid=1222 uid=1000 name=demo scontext=u:r:system_server:s0 tcontext=u:object_r:default_android_service:s0 tclass=service_manager permissive=0
16:37:47.143  0      0      :                           [0:   Binder:695_2:  706]
16:37:47.146  1222   1222   SystemServerTiming:         StartDemoManagerService took to complete: 7ms

链接：https://www.jianshu.com/p/74971ee85a8b
作者:行走中的3卡

最后

如果你想要深入系统的学习Android Framework框架，这里可以分享一份《Android Framework源码开发揭秘》，其中记录了从系统启动流程到WMS全部源码解析，相信你能优秀地学习整个Framework框架。扫描下方二维码直接领取！

第一章系统启动流程分析

第一节 Android启动概览
第二节 init.rc解析
第三节 Zygote
第四节面试题

在这里插入图片描述

第二章跨进程通信IPC解析

第一节 Sercice 还可以这么理解
第二节 Binder基础
第三节 Binder应用
第四节 AIDL应用（上）
第五节 AIDL应用（下）
第六节 Messenger原理及应用
第七节服务端回调
第八节获取服务（IBinder）
第九节 Binder面试题全解析

在这里插入图片描述

第三章 Handler源码解析

第一节源码分析
第二节难点问题
第三节 Handler常问面试题

第四章 AMS源码解析

第一节引言
第二节 Android架构
第三节通信方式
第四节系统启动系列
第五节 AMS
第六节 AMS 面试题解析

在这里插入图片描述

第五章 WMS源码解析

第一节 WMS与activity启动流程
第二节 WMS绘制原理
第三节 WMS角色与实例化过程
第四节 WMS工作原理

在这里插入图片描述

第六章 Surface源码解析

第一节创建流程及软硬件绘制
第二节双缓冲及SurfaceView解析
第三节 Android图形系统综述

第七章基于Android12.0的SurfaceFlinger源码解析

第一节应用建立和SurfaceFlinger的沟通的桥梁
第二节 SurfaceFlinger的启动和消息队列处理机制
第三节 SurfaceFlinger 之 VSync（上）
第四节 SurfaceFlinger之VSync（中）
第五节 SurfaceFlinger之VSync（下）

第八章 PKMS源码解析

第一节 PKMS调用方式
第二节 PKMS启动过程分析
第三节 APK的扫描
第四节 APK的安装
第五节 PKMS之权限扫描
第六节静默安装
第七节 requestPermissions源码流程解析

在这里插入图片描述

第九章 InputManagerService源码解析

第一节 Android Input输入事件处理流程（1）
第二节 Android Input输入事件处理流程（2）
第三节 Android Input输入事件处理流程（3）

在这里插入图片描述

第十章 DisplayManagerService源码解析

第一节 DisplayManagerService启动
第二节 DisplayAdapter和DisplayDevice的创建
第三节 DMS部分亮灭屏流程
第四节亮度调节
第五节 Proximity Sensor灭屏原理
第六节 Logical Display和Physical Display配置的更新

在这里插入图片描述

各位小伙伴们如果有需要这份《Android Framework源码开发揭秘》资料，点击下方卡片即可【免费领取】

Android学习小分队

关注

0
点赞
踩
4

收藏

觉得还不错? 一键收藏
0
评论
Android Framework 添加新的系统服务

如果你想要深入系统的学习Android Framework框架，这里可以分享一份《Android Framework源码开发揭秘》，其中记录了从系统启动流程到WMS全部源码解析，相信你能优秀地学习整个Framework框架。扫描下方二维码直接领取！
复制链接

扫一扫