AOSP开发中遇到的@TestApi注解具体含义是什么？

@TestApi是AOSP源码中专属的注解类型，用于标记仅允许平台内部测试场景调用、不对第三方应用开放的类、方法或字段。

核心特性 #

• 接口可见性限制：被该注解标记的元素虽然Java语法定义为public，但不会被编入官方公开的Android SDK，普通第三方应用开发阶段无法引用这些接口；只有编译AOSP内置测试套件（如CTS、单元测试用例）时，才允许访问这类接口。
• 与@hide注解的关联：你给出的示例中同时存在@hide和@TestApi是常规用法：@hide的作用是将对应接口从公开SDK中剔除，而@TestApi是在@hide的基础上额外开放白名单权限——只有标注了@TestApi的隐藏接口，才允许平台测试用例调用，其余未加该注解的隐藏接口，就连平台内部测试也不允许随意调用。
• 无兼容性承诺：被@TestApi标记的接口不存在跨版本兼容保证，Android版本迭代过程中可能被任意修改、删除，即便是ROM定制开发，也不建议在正式业务逻辑中调用这类接口，避免后续版本升级时出现兼容性故障。

你给出的示例就是典型的@TestApi使用场景：

/**
 * @hide
 */
@TestApi
public boolean isBound() {
    if (!mIsConnected) {
        Log.w(TAG, "Condition provider service not yet bound.");
    }
    return mIsConnected;
}

该isBound()方法仅用于平台测试用例验证服务绑定状态，不会对外开放给第三方开发者使用。

内容的提问来源于stack exchange，提问作者Bazouk55555