天天看点

Android输入系统源码分析

参考:《深入理解Android 卷III》

 输入事件的源头是位于/dev/input/下的设备节点,而输入系统的终点是由WMS管理的某个窗口。最初的输入事件为内核生成的原始事件,而最终交付给窗口的则是KeyEvent或MotionEvent对象。因此Android输入系统的主要工作是读取设备节点中的原始事件,将其加工封装,然后派发给一个特定的窗口以及窗口中的控件。这个过程由InputManagerService系统服务为核心的多个参与者共同完成。输入系统的总体流程和参与者如图所示。

Android输入系统源码分析
  • Linux内核,接受输入设备的中断,并将原始事件的数据写入到设备节点中。
  • 设备节点,作为内核与IMS的桥梁,它将原始事件的数据暴露给用户空间,以便IMS可以从中读取事件。
  • InputManagerService,一个Android系统服务,它分为Java层和Native层两部分。Java层负责与WMS的通信。而Native层则是InputReader和InputDispatcher两个输入系统关键组件的运行容器。
  • EventHub,直接访问所有的设备节点。并且正如其名字所描述的,它通过一个名为getEvents()的函数将所有输入系统相关的待处理的底层事件返回给使用者。这些事件包括原始输入事件、设备节点的增删等。
  • InputReader,是IMS中的关键组件之一。它运行于一个独立的线程Reader线程中,通过其线程循环不断地通过getEvents()函数从EventHub中将事件取出并进行处理。然后交给InputDispatcher进行派发。
  • InputDispatcher,是IMS中的另一个关键组件。它也运行于一个独立的线程中Dispatcher线程中。InputDispatcher中保管了来自WMS的所有窗口的信息,其收到来自InputReader的输入事件后,会在其保管的窗口中寻找合适的窗口,并将事件派发给此窗口。
  • WMS,虽说不是输入系统中的一员,但是它却对InputDispatcher的正常工作起到了至关重要的作用。当新建窗口时,WMS为新窗口和IMS创建了事件传递所用的通道。另外,WMS还将所有窗口的信息,包括窗口的可点击区域,焦点窗口等信息,实时地更新到IMS的InputDispatcher中,使得InputDispatcher可以正确地将事件派发到指定的窗口。

以下是代码分析,建议用sourceinsight进行代码跟踪。

输入系统会创建Reader线程和Dispatcher线程

Reader线程和Dispatcher线程创建及启动过程源码分析:

SystemServer所有服务被创建的源头,同其他系统服务一样,IMS在SystemServer中被启动。

SystemServer.java (frameworks\base\services\java\com\android\server)
private void startOtherServices() {
    inputManager = new InputManagerService(context);     //创建InputManagerService
    inputManager.start();                                //启动这个服务
}
           
InputManagerService.java (frameworks\base\services\core\java\com\android\server\input)
public InputManagerService(Context context) {
    mPtr = nativeInit(this, mContext, mHandler.getLooper().getQueue());       //调用本地方法进行初始化  
}
public void start() {
    nativeStart(mPtr);             //调用本地nativeStart函数
}
           

调用native方法,创建Reader线程和Dispatcher线程并启动

com_android_server_input_InputManagerService.cpp (frameworks\base\services\core\jni)    
static jlong nativeInit {
    /* 创建了一个NativeInputManager对象,此对象将是Native层组件与Java层IMS进行通信的桥梁 */
    NativeInputManager* im = new NativeInputManager(contextObj, serviceObj, messageQueue->getLooper());
}
NativeInputManager::NativeInputManager {
    //NativeInputManager创建了EventHub,EventHub复杂的构造函数使其在创建后便拥有了监听设备节点的能力(Inotify和epoll机制)
    sp<EventHub> eventHub = new EventHub();

    // 接着创建了Native层的InputManager    
    mInputManager = new InputManager(eventHub, this, this);
}

被InputManagerService的start函数所调用来启动线程。
static void nativeStart(JNIEnv* env, jclass clazz, jlong ptr) {
    NativeInputManager* im = reinterpret_cast<NativeInputManager*>(ptr);

    status_t result = im->getInputManager()->start();
}
           

InputManager统一创建并管理mReader、mReaderThread、mDispatcher、mDispatcherThread这四个实例化对象。

InputManager.cpp (frameworks\native\services\inputflinger)  
class InputManager {
    sp<InputReaderInterface> mReader;
    sp<InputReaderThread> mReaderThread;

    sp<InputDispatcherInterface> mDispatcher;
    sp<InputDispatcherThread> mDispatcherThread;
}
/* 在InputManager中创建InputDispatcher和InputReader实例化对象 */
InputManager::InputManager {
    mDispatcher = new InputDispatcher(dispatcherPolicy);
    mReader = new InputReader(eventHub, readerPolicy, mDispatcher);
    initialize();
}
void InputManager::initialize() {
    //创建Reader线程和Dispatcher线程
    mReaderThread = new InputReaderThread(mReader);
    mDispatcherThread = new InputDispatcherThread(mDispatcher);
}

status_t InputManager::start() {
    /* 启动ReaderThread和DispatcherThread */
    status_t result = mDispatcherThread->run("InputDispatcher", PRIORITY_URGENT_DISPLAY);
    result = mReaderThread->run("InputReader", PRIORITY_URGENT_DISPLAY);
}
           

mDispatcherThread->run和mReaderThread->run分别会执行InputReaderThread和InputDispatcherThread线程的线程循环体。

InputReader.cpp (frameworks\native\services\inputflinger)   
/* 创建InputReaderThread线程,实现循环操作 */
bool InputReaderThread::threadLoop() {
    mReader->loopOnce();    // 执行InputReader的loopOnce()函数
    return true;
}
InputReaderThread启动后,其线程循环将不断地执行InputReader.loopOnce()函数。因此这个loopOnce()函数作为线程循环的循环体包含了InputReader的所有工作。

InputDispatcher.cpp (frameworks\native\services\inputflinger)   
bool InputDispatcherThread::threadLoop() {
    mDispatcher->dispatchOnce();
    return true;
}
           

至此,IMS的创建完成了。InputManager的创建过程分别为InputReader与InputDispatcher创建了承载它们运行的线程,此时start()函数的功能就是启动这两个线程,使得InputReader于InputDispatcher开始工作。

EventHub分析(Reader线程使用EventHub读取事件):

getEvents读取的输入事件是一个RawEvent结构体             *       Linux驱动上报的输入事件是input_event结构体
struct RawEvent {                                    *        struct input_event {                                      
    nsecs_t when;                                    *          struct timeval time;                                        
    int32_t deviceId;                                *          __u16 type;                                                  
    int32_t type;                                    *          __u16 code;                                                 
    int32_t code;                                    *          __s32 value;                                                
    int32_t value;                                   *        };                                                        
};                                                   *
                                                     *
type:                                               *        type:       
DEVICE_ADDED              //输入设备插入               *        EV_KEY
DEVICE_REMOVED            //输入设备拔掉               *        EV_ABS
FINISHED_DEVICE_SCAN      //有设备上报了输入事件        *        EV_REL
EV_KEY                                               *
EV_ABS                                               *
EV_REL                                               *
           

EventHub中使用RawEvent结构体是对input_event结构体的扩展,根据类型和源码可知,EventHub使用inotify检测/dev/input目录下设备的插入或者拔出,使用epoll检测/dev/input/eventx有无数据。

EventHub.cpp (frameworks\native\services\inputflinger)
在EventHub的构造函数中使用inotify和epoll机制检测/dev/input目录下设备的插入或者拔出
EventHub::EventHub(void){ 
    /* 初始化一个inotify句柄 */
    mINotifyFd = inotify_init();
    /* 将/dev/input目录添加到句柄中 */
    int result = inotify_add_watch(mINotifyFd, DEVICE_PATH, IN_DELETE | IN_CREATE);    
    //static const char *DEVICE_PATH = "/dev/input";

    mEpollFd = epoll_create(EPOLL_SIZE_HINT);
    /* 将inotify句柄添加到epoll的检测列表中,开始检测 */
    result = epoll_ctl(mEpollFd, EPOLL_CTL_ADD, mINotifyFd, &eventItem);
}
           

获取输入事件 – getEvent函数

size_t EventHub::getEvents(int timeoutMillis, RawEvent* buffer, size_t bufferSize) {
    /* 这个循环是getEvents()函数的主体。在这个循环中,会先将可用事件放入到buffer中并返回。
     如果没有可用事件,则进入epoll_wait()等待事件的到来,epoll_wait()返回后会重新循环将可用
     将新事件放入buffer */
    for (;;) {
        /* 扫描目录下的所有设备看是否有设备插入或者删除 */
        scanDevicesLocked();
            status_t res = scanDirLocked(DEVICE_PATH);
                dir = opendir(dirname);
                while((de = readdir(dir)))
                    openDeviceLocked(devname) {
                        /* 打开/dev/input/eventx */
                        int fd = open(devicePath, O_RDWR | O_CLOEXEC);
                        /* 获取版本号,GID等等 */
                        ioctl(fd, EVIOCGVERSION, &driverVersion)
                        ioctl(fd, EVIOCGID, &inputId)
                        ....

                        /* 将打开的文件的fd添加到epoll检测列表中,检测是否有数据产生 */
                        epoll_ctl(mEpollFd, EPOLL_CTL_ADD, fd, &eventItem)
                    }

        /* 如果EPOLL_ID_INOTIFY,说明/dev/input目录有变化(增加或者删除设备),mPendingEventIndex指定尚未
        处理的epoll_event的索引 */
        while (mPendingEventIndex < mPendingEventCount) {
            const struct epoll_event& eventItem = mPendingEventItems[mPendingEventIndex++];
            if (eventItem.data.u32 == EPOLL_ID_INOTIFY) {
                mPendingINotify = true;     //更改标记位为true
            }

            /* 如果EPOLLIN,说明有输入事件产生,则去读取输入事件 */
           if (eventItem.events & EPOLLIN) {
              int32_t readSize = read(device->fd, readBuffer,sizeof(struct input_event) * capacity);    /* 读取的输入数据是input_event结构体 */

              /* 将读取到的input_event结构体转换为EventHub中对应的RawEvent结构体 */
              size_t count = size_t(readSize) / sizeof(struct input_event);
              for (size_t i = ; i < count; i++) {
                 event->type = iev.type;         //RawEvent* event;
                 event->code = iev.code;
                 event->value = iev.value;
                 event += ;
              }
           }
        }

        /* 如果标记位为true,则去读取notify */
        if (mPendingINotify && mPendingEventIndex >= mPendingEventCount) {
            mPendingINotify = false;
            readNotifyLocked(); {
                //如果是插入了新的设备,那么就调用openDeviceLocked去打开这个设备,然后获取各种信息,并添加到
                //检测列表(上面分析过)
                if(event->mask & IN_CREATE) 
                openDeviceLocked(devname);  
            }
            deviceChanged = true;
         }

        // Report added or removed devices immediately.
        //设备节点增删操作发生时,则重新执行循环体,以便将设备变化的事件放入buffer中
        if (deviceChanged) {
           continue;
        }

        // 如果此次getEvents()调用成功获取了一些事件,或者要求唤醒InputReader,则退出循环并
        // 结束getEvents()的调用,使InputReader可以立刻对事件进行处理
        if(event != buffer || awoken) {
            break;
        }

        /* 不断的循环检测/dev/input下的所有设备epoll_wait()所取出的epoll_event存储在mPendingEventItems
           中,mPendingEventCount指定了mPendingEventItems数组所存储的事件个数。*/
        int pollResult = epoll_wait(mEpollFd, mPendingEventItems, EPOLL_MAX_EVENTS, timeoutMillis);
    }  //end of for(;;)

  // All done, return the number of events we read.
  return event - buffer;
}
           

深入分析Reader线程

/*通过EventHub获取事件列表。读取的结果存储在参数mEventBuffer中,返回值表示事件的个数
  当EventHub中无事件可以抽取时,此函数的调用将会阻塞直到事件到来或者超时 */
void InputReader::loopOnce() {
    /* 获取输入事件,参照下文EventHub分析 */
    size_t count = mEventHub->getEvents(timeoutMillis, mEventBuffer, EVENT_BUFFER_SIZE);

    //如果有输入事件发生,则调用processEventsLocked()函数对事件进行加工处理
    if (count) {
       processEventsLocked(mEventBuffer, count);
    }

    /*发布事件。 processEventsLocked()函数在对事件进行加工处理之后,便将处理后的事件存储在
    mQueuedListener中。在循环的最后,通过调用flush()函数将所有事件交付给InputDispatcher */
    mQueuedListener->flush();
}
           

对事件进行加工处理:

void InputReader::processEventsLocked(const RawEvent* rawEvents, size_t count) {
    for (const RawEvent* rawEvent = rawEvents; count;) {
        /* 当有真正的输入事件,则调用processEventsForDeviceLocked进行处理 */
        processEventsForDeviceLocked(deviceId, rawEvent, batchSize);

        /* 把所有的事件(插入新的输入设备/拔掉了一个输入设备/输入设备有输入事件产生)都抽取出来,进行判断 */
        switch (rawEvent->type) {
        case EventHubInterface::DEVICE_ADDED:
            /* 对于增加新设备的时间,会在InputReader里面构造一下input_device结构体进行记录 */
            addDeviceLocked(rawEvent->when, rawEvent->deviceId);
            break;
        case EventHubInterface::DEVICE_REMOVED:
            removeDeviceLocked(rawEvent->when, rawEvent->deviceId);
            break;
        case EventHubInterface::FINISHED_DEVICE_SCAN:                   //扫描输入事件
            handleConfigurationChangedLocked(rawEvent->when);
            break;
      }
    }
}
           

具体处理

processEventsForDeviceLocked(deviceId, rawEvent, batchSize);
{
    InputDevice* device = mDevices.valueAt(deviceIndex);
    device->process(rawEvents, count);  
    {
        InputMapper* mapper = mMappers[i];
        mapper->process(rawEvent);  
        {
            /* 对于键盘,调用Keyboard的process */
            void KeyboardInputMapper::process(const RawEvent* rawEvent)
            {
                /* 映射:scanCode是驱动程序上报的扫描码  转换为Android系统中的keyCode */
                getEventHub()->mapKey(getDeviceId(), scanCode, usageCode, &keyCode, &flags) 
                {//eventhub.cpp
                    /* 映射的时候会先使用kl文件映射,如果失败再使用kcm文件映射 */
                    status_t EventHub::mapKey(int32_t deviceId, int32_t scanCode, int32_t usageCode, int32_t* outKeycode, uint32_t* outFlags)   
                    }

                    /* 映射成功,则进行处理 */
                    processKey(rawEvent->when, rawEvent->value != , keyCode, scanCode, flags);
                    {
                        /* 根据参数构造args:down/up,keyCode scanCode newMetaState(是否有shift按下) */
                        NotifyKeyArgs args(when, getDeviceId(), mSource, policyFlags, down ? AKEY_EVENT_ACTION_DOWN : AKEY_EVENT_ACTION_UP, AKEY_EVENT_FLAG_FROM_SYSTEM, keyCode, scanCode, newMetaState, downTime);
                        /* 然后通知listener来进行处理,把args发给dispatch线程 */
                        getListener()->notifyKey(&args);    
                    }
              } 
         }
    }
}
           

总结:Reader线程对输入事件的处理很简单,就是把驱动上报的scancode转换为Android的AKEYCODE码,然后构造成args参数,最后传递给dispatcher线程。

Reader线程到Dispatcher线程间数据的传递:

在分析InputManager.cpp的时候分析过,InputManager管理四个对象mReader mReaderThread mDispatcher mDispatcherThread

在InputManager的构造函数中创建mReader对象,其中第三个参数是一个listener:
/*
    InputReader::InputReader(const sp<EventHubInterface>& eventHub,
        const sp<InputReaderPolicyInterface>& policy,
        const sp<InputListenerInterface>& listener)
 */
mReader = new InputReader(eventHub, readerPolicy, mDispatcher);

所以getListener()->notifyKey(&args);中getListener()获取的是一个mDispatcher对象,notifyKey是Dispatcher中的notifyKey方法.
           

Dispatcher线程分析:

接收数据

InputDispatcher.cpp (frameworks\native\services\inputflinger)   
void InputDispatcher::notifyKey(const NotifyKeyArgs* args) {
      /* 将从Reader线程传进来的args参数构造成一个KeyEvent结构体 */
      KeyEvent event;
      event.initialize(args->deviceId, args->source, args->action,
            flags, keyCode, args->scanCode, metaState, ,
            args->downTime, args->eventTime);

        /* 然后对传入的输入事件简单处理 */
        mPolicy->interceptKeyBeforeQueueing(&event, /*byref*/ policyFlags);
        {//NativeInputManager::interceptKeyBeforeQueueing
                       com_android_server_input_InputManagerService.cpp 
            /* 调用phonewindowmanager.java中的同名函数,返回一个wmActions */
            wmActions = env->CallIntMethod(mServiceObj, gServiceClassInfo.interceptKeyBeforeQueueing, keyEventObj, policyFlags);
            {//interceptKeyBeforeQueueing  PhoneWindowManager.java 
                (frameworks\base\policy\src\com\android\internal\policy\impl)
                /* 如果是global按键,则直接返回ACTION_PASS_TO_USER */
                if (mGlobalKeyManager.shouldHandleGlobalKey(keyCode, event))
                    return result;   //result = ACTION_PASS_TO_USER;

                /* 对于systemkey 分类处理 */
                可以直接处理的话,处理它,设置返回值 !ACTION_PASS_TO_USER,不要传给用户否则ACTION_PASS_TO_USER                 
                }

                /* 根据返回值,设置policyFlags:POLICY_FLAG_PASS_TO_USER  */
                handleInterceptActions(wmActions, when, /*byref*/ policyFlags);
                if (wmActions & WM_ACTION_PASS_TO_USER) {
                    policyFlags |= POLICY_FLAG_PASS_TO_USER;
        }

        /* 然后放入inbound队列中 */
        needWake = enqueueInboundEventLocked(newEntry);

        if (needWake) {
            mLooper->wake();   //唤醒dispatch线程
        }
}
           

dispatch线程循环体分析

threadLoop() InputDispatcher.cpp 
mDispatcher->dispatchOnce();
{
    if (!haveCommandsLocked())    //没有命令则从inbound队列中取出事件,生成命令
       dispatchOnceInnerLocked(&nextWakeupTime);
       {
          mPendingEvent = mInboundQueue.dequeueAtHead();   //从inbound队列中取出事件
          DropReason dropReason = DROP_REASON_NOT_DROPPED; //默认不丢弃

          对于:!POLICY_FLAG_PASS_TO_USER
          if (!(mPendingEvent->policyFlags & POLICY_FLAG_PASS_TO_USER))  
              dropReason = DROP_REASON_POLICY;      
                switch (mPendingEvent->type) 
                case EventEntry::TYPE_KEY: 
                    dispatchKeyLocked
                    {
                        // Clean up if dropping the event.
                        if (*dropReason != DROP_REASON_NOT_DROPPED) 
                            return true;    //返回后会不休眠继续执行dispatchOnce,处理下一个输入事件
                    }

        对于:POLICY_FLAG_PASS_TO_USER
        switch (mPendingEvent->type) 
        case EventEntry::TYPE_KEY: 
            dispatchKeyLocked
            {
                if (entry->interceptKeyResult == KeyEntry::INTERCEPT_KEY_RESULT_UNKNOWN) {
                    if (entry->policyFlags & POLICY_FLAG_PASS_TO_USER) {
                        //构造命令放入队列
                        CommandEntry* commandEntry = postCommandLocked(                                           &InputDispatcher::doInterceptKeyBeforeDispatchingLockedInterruptible);
                        if (mFocusedWindowHandle != NULL) {
                            commandEntry->inputWindowHandle = mFocusedWindowHandle;
                        }
                        commandEntry->keyEntry = entry;
                        entry->refCount += ;
                        return false; // wait for the command to run
                    }
                }

                /* 如果解析的结果是INTERCEPT_KEY_RESULT_CONTINUE,则寻找目标应用程序 */
                int32_t injectionResult = findFocusedWindowTargetsLocked(currentTime, entry, inputTargets, nextWakeupTime);
                // Dispatch the key.   然后把事件发给应用程序
                dispatchEventLocked(currentTime, entry, inputTargets);
            }
       }

       if (runCommandsLockedInterruptible())  //运行命令
       {
          /* 取出命令,然后执行命令 */
          CommandEntry* commandEntry = mCommandQueue.dequeueAtHead();
          //命令即doInterceptKeyBeforeDispatchingLockedInterruptible
          Command command = commandEntry->command;    
          {//doInterceptKeyBeforeDispatchingLockedInterruptible
             /* 执行phonewindowmanager.java中的同名函数 */
            nsecs_t delay = mPolicy->interceptKeyBeforeDispatching(commandEntry->inputWindowHandle, &event, entry->policyFlags);

            {//interceptKeyBeforeDispatching   PhoneWindowManager.java
            if (mGlobalKeyManager.handleGlobalKey(mContext, keyCode, event))
                {//根据global_key.xml发送广播给某个组件
                ComponentName component = mKeyMapping.get(keyCode);
                context.sendBroadcastAsUser(intent, UserHandle.CURRENT, null);  
                }
                return -;
            }

            /* 根据返回值来设置解析的结果 */
            if (delay < )   //返回-1, 不上传给app  -- global key      system key
                entry->interceptKeyResult = KeyEntry::INTERCEPT_KEY_RESULT_SKIP;
            else if (!delay)    //return 0,表示让app处理  -- user key
                entry->interceptKeyResult = KeyEntry::INTERCEPT_KEY_RESULT_CONTINUE;
            else
                entry->interceptKeyResult = KeyEntry::INTERCEPT_KEY_RESULT_TRY_AGAIN_LATER;
            entry->interceptKeyWakeupTime = now() + delay;
           }
       }
       nextWakeupTime = LONG_LONG_MIN;
}
           

分析到此结束,有误的地方还请提出宝贵的意见!

最后再次感谢《深入理解Android 卷III》这本书,通过看这本书我学到了很多东西,同时,书中有很多语言组织的非常好,我就照搬过来了。