指纹authenticate流程图

#mermaid-svg-Np7B2Zk7aHDSycIz{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-Np7B2Zk7aHDSycIz .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-Np7B2Zk7aHDSycIz .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-Np7B2Zk7aHDSycIz .error-icon{fill:#552222;}#mermaid-svg-Np7B2Zk7aHDSycIz .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-Np7B2Zk7aHDSycIz .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-Np7B2Zk7aHDSycIz .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-Np7B2Zk7aHDSycIz .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-Np7B2Zk7aHDSycIz .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-Np7B2Zk7aHDSycIz .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-Np7B2Zk7aHDSycIz .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-Np7B2Zk7aHDSycIz .marker{fill:#333333;stroke:#333333;}#mermaid-svg-Np7B2Zk7aHDSycIz .marker.cross{stroke:#333333;}#mermaid-svg-Np7B2Zk7aHDSycIz svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-Np7B2Zk7aHDSycIz p{margin:0;}#mermaid-svg-Np7B2Zk7aHDSycIz .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-Np7B2Zk7aHDSycIz .cluster-label text{fill:#333;}#mermaid-svg-Np7B2Zk7aHDSycIz .cluster-label span{color:#333;}#mermaid-svg-Np7B2Zk7aHDSycIz .cluster-label span p{background-color:transparent;}#mermaid-svg-Np7B2Zk7aHDSycIz .label text,#mermaid-svg-Np7B2Zk7aHDSycIz span{fill:#333;color:#333;}#mermaid-svg-Np7B2Zk7aHDSycIz .node rect,#mermaid-svg-Np7B2Zk7aHDSycIz .node circle,#mermaid-svg-Np7B2Zk7aHDSycIz .node ellipse,#mermaid-svg-Np7B2Zk7aHDSycIz .node polygon,#mermaid-svg-Np7B2Zk7aHDSycIz .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-Np7B2Zk7aHDSycIz .rough-node .label text,#mermaid-svg-Np7B2Zk7aHDSycIz .node .label text,#mermaid-svg-Np7B2Zk7aHDSycIz .image-shape .label,#mermaid-svg-Np7B2Zk7aHDSycIz .icon-shape .label{text-anchor:middle;}#mermaid-svg-Np7B2Zk7aHDSycIz .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-Np7B2Zk7aHDSycIz .rough-node .label,#mermaid-svg-Np7B2Zk7aHDSycIz .node .label,#mermaid-svg-Np7B2Zk7aHDSycIz .image-shape .label,#mermaid-svg-Np7B2Zk7aHDSycIz .icon-shape .label{text-align:center;}#mermaid-svg-Np7B2Zk7aHDSycIz .node.clickable{cursor:pointer;}#mermaid-svg-Np7B2Zk7aHDSycIz .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-Np7B2Zk7aHDSycIz .arrowheadPath{fill:#333333;}#mermaid-svg-Np7B2Zk7aHDSycIz .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-Np7B2Zk7aHDSycIz .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-Np7B2Zk7aHDSycIz .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Np7B2Zk7aHDSycIz .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-Np7B2Zk7aHDSycIz .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Np7B2Zk7aHDSycIz .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-Np7B2Zk7aHDSycIz .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-Np7B2Zk7aHDSycIz .cluster text{fill:#333;}#mermaid-svg-Np7B2Zk7aHDSycIz .cluster span{color:#333;}#mermaid-svg-Np7B2Zk7aHDSycIz div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-Np7B2Zk7aHDSycIz .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-Np7B2Zk7aHDSycIz rect.text{fill:none;stroke-width:0;}#mermaid-svg-Np7B2Zk7aHDSycIz .icon-shape,#mermaid-svg-Np7B2Zk7aHDSycIz .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Np7B2Zk7aHDSycIz .icon-shape p,#mermaid-svg-Np7B2Zk7aHDSycIz .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-Np7B2Zk7aHDSycIz .icon-shape .label rect,#mermaid-svg-Np7B2Zk7aHDSycIz .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Np7B2Zk7aHDSycIz .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-Np7B2Zk7aHDSycIz .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-Np7B2Zk7aHDSycIz :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} Goodix驱动/芯片
HAL 进程 -- vendor/goodix/aidl 本目录
system_server 进程 -- Framework
App 进程
Binder跨进程
Binder跨进程,进入vendor HAL
notify回调
mClientCallback->onAuthenticationSucceeded/Failed
Binder跨进程,返回system_server
Binder跨进程,回到App
App调用 FingerprintManager.authenticate
Binder: IFingerprintService.aidl
FingerprintService.java Stub 实现
FingerprintProvider.scheduleAuthenticate 创建Client
FingerprintAuthenticationClient.start
AuthenticationClient.start 做锁定检查
startHalOperation 显示指纹UI覆层
doAuthenticate 拿到AidlSession
ISession.aidl: authenticate/authenticateWithContext
Session.cpp::authenticate
丢进WorkerThread异步执行
FingerprintEngine::authenticateImpl
HAL侧再次checkLockoutMode
mDevice->authenticate 下发
采集指纹并比对
FingerprintEngine::notify/notifyInternal
ISessionCallback.aidl
框架侧ISessionCallback实现

一般叫AidlResponseHandler类

转发给对应Client
FingerprintAuthenticationClient

.onAuthenticationSucceeded/Failed
通过ClientMonitorCallbackConverter

调IFingerprintServiceReceiver
AuthenticationCallback

.onAuthenticationSucceeded/Failed

1.APP先调用接口FingerprintManager.java的authenticate()

    @Deprecated
    @RequiresPermission(anyOf = {USE_BIOMETRIC, USE_FINGERPRINT})
    public void authenticate(@Nullable CryptoObject crypto, @Nullable CancellationSignal cancel,
            int flags, @NonNull AuthenticationCallback callback, @Nullable Handler handler) {
        authenticate(crypto, cancel, callback, handler, SENSOR_ID_ANY, mContext.getUserId(), flags);
    }

2.建立App 进程（Client）与 SystemServer 进程（Service）之间的 Binder 通信接口规范IFingerprintService.aidl的authenticate()

    long authenticate(IBinder token, long operationId, IFingerprintServiceReceiver receiver,
              in FingerprintAuthenticateOptions options);

3.IFingerprintService.java的authenticate()完成相应操作

    long authenticate(IBinder token, long operationId, IFingerprintServiceReceiver receiver,
            in FingerprintAuthenticateOptions options);

4.FingerprintProvider.java的scheduleAuthenticate()创建客户端

    public long scheduleAuthenticate(@NonNull IBinder token, long operationId,
            int cookie, @NonNull ClientMonitorCallbackConverter callback,
            @NonNull FingerprintAuthenticateOptions options, boolean restricted, int statsClient,
            boolean allowBackgroundAuthentication) {
        final long id = mRequestCounter.incrementAndGet();

        scheduleAuthenticate(token, operationId, cookie, callback,
                options, id, restricted, statsClient, allowBackgroundAuthentication);

        return id;
    }

5.这里比较绕，外部代码-调用子类FingerprintAuthenticationClient.java的start()，子类start的super.start(callback)-跳进父类AuthenticationClient.java的 start()，父类start内部做framework锁定次数检查，然后调用this.startHalOperation()，java多态，this是子类对象，跑的是子类的startHalOperation()，父类的逻辑完成后，super.start(callback)走完，回到子类start()

    /**
     * Start authentication
	 AuthenticationClient.java的 start()
     */
    @Override
    public void start(@NonNull ClientMonitorCallback callback) {
        super.start(callback);

        final @LockoutTracker.LockoutMode int lockoutMode;
        if (mShouldUseLockoutTracker) {
            lockoutMode = mLockoutTracker.getLockoutModeForUser(getTargetUserId());
        } else {
            lockoutMode = getBiometricContext().getAuthSessionCoordinator()
                    .getLockoutStateFor(getTargetUserId(), mSensorStrength);
        }

        if (lockoutMode != LockoutTracker.LOCKOUT_NONE) {
            Slog.v(TAG, "In lockout mode(" + lockoutMode + ") ; disallowing authentication");
            int errorCode = lockoutMode == LockoutTracker.LOCKOUT_TIMED
                    ? BiometricConstants.BIOMETRIC_ERROR_LOCKOUT
                    : BiometricConstants.BIOMETRIC_ERROR_LOCKOUT_PERMANENT;
            onError(errorCode, 0 /* vendorCode */);
            return;
        }

        if (mTaskStackListener != null) {
            mActivityTaskManager.registerTaskStackListener(mTaskStackListener);
        }

        Slog.d(TAG, "Requesting auth for " + getOwnerString());

        mStartTimeMs = System.currentTimeMillis();
        mAuthAttempted = true;
        startHalOperation();
    }
	
	/**
     * FingerprintAuthenticationClient.java
     */
    @Override
    public void start(@NonNull ClientMonitorCallback callback) {
        super.start(callback);

        if (mSensorProps.isAnyUdfpsType()) {
            // UDFPS requires user to touch before becoming "active"
            mState = STATE_STARTED_PAUSED;
        } else {
            mState = STATE_STARTED;
        }
    }

6.startHalOperation()再去doAuthenticate();

    @Override
    protected void startHalOperation() {
        mSensorOverlays.show(getSensorId(), getRequestReason(), this);
        mAuthenticationStateListeners.onAuthenticationStarted(new AuthenticationStartedInfo
                .Builder(BiometricSourceType.FINGERPRINT, getRequestReason()).build()
        );
        try {
            doAuthenticate();
        } catch (RemoteException e) {
            Slog.e(TAG, "Remote exception", e);
            onError(
                    BiometricFingerprintConstants.FINGERPRINT_ERROR_HW_UNAVAILABLE,
                    0 /* vendorCode */);
            mSensorOverlays.hide(getSensorId());
            mCallback.onClientFinished(this, false /* success */);
        }
    }

7.doAuthenticate()会获取对应的AidlSession,session.getSession()

    private void doAuthenticate() throws RemoteException {
        final AidlSession session = getFreshDaemon();
        final OperationContextExt opContext = getOperationContext();

        getBiometricContext().subscribe(opContext, ctx -> {
            try {
                if (session.hasContextMethods()) {
                    mCancellationSignal = session.getSession().authenticateWithContext(mOperationId,
                            ctx);
                } else {
                    mCancellationSignal = session.getSession().authenticate(mOperationId);
                }

                if (getBiometricContext().isAwake()) {
                    mALSProbeCallback.getProbe().enable();
                } else {
                    mALSProbeCallback.getProbe().disable();
                }
            } catch (RemoteException e) {
                Slog.e(TAG, "Remote exception", e);
                onError(
                        BiometricFingerprintConstants.FINGERPRINT_ERROR_HW_UNAVAILABLE,
                        0 /* vendorCode */);
                mSensorOverlays.hide(getSensorId());
                mCallback.onClientFinished(this, false /* success */);
            }
        }, ctx -> {
            if (session.hasContextMethods()) {
                try {
                    session.getSession().onContextChanged(ctx);
                } catch (RemoteException e) {
                    Slog.e(TAG, "Unable to notify context changed", e);
                }
            }

            final boolean isAwake = getBiometricContext().isAwake();
            if (isAwake) {
                mALSProbeCallback.getProbe().enable();
            } else {
                mALSProbeCallback.getProbe().disable();
            }
        }, getOptions());
    }

8.AidlSession.java的getSession()会返回mSession

    @NonNull public ISession getSession() {
        return mSession;
    }

9.ISession.aidl的authenticate()

ICancellationSignal authenticate(in long operationId);