appfunctions

  
앱이 AI 어시스턴트와 기능 및 데이터를 공유하여 어시스턴트가 기기에서 직접 작업을 검색하고 실행하여 사용자 요청을 처리할 수 있도록 합니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2026년 7월 1일 - - - 1.0.0-alpha10

종속 항목 선언

appfunctions의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소 를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha10"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha10"
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp "androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha10")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha10")
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

이 아티팩트의 출시 노트는 없습니다.

버전 1.0

버전 1.0.0-alpha10

2026년 7월 1일

androidx.appfunctions:appfunctions:1.0.0-alpha10, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10, androidx.appfunctions:appfunctions-testing:1.0.0-alpha10이 출시되었습니다. 버전 1.0.0-alpha10에 포함된 커밋을 확인하세요.

API 변경사항

  • AppFunctionServiceEntryPoint를 추가했습니다. 모든 AppFunction 주석은 AppFunctionService로 주석 처리된 AppFunctionServiceEntryPoint 내에서 선언해야 합니다. (Idc5d5, b/463909015)
  • AppFunction 및 AppFunctionConfiguration API를 이동했습니다 . AppFunctionConfiguration은 AppFunctionServiceEntryPoint로 대체되므로 향후 출시에서 삭제됩니다. (Iaff23, I4cf3e, b/517876475)
  • 콜백을 지원하도록 AppFunctionService API를 업데이트했습니다. (I6e0d7, b/519880977)
  • searchAppFunctions API를 추가했습니다. (I8c0f9, I1fa27, b/494239238)
  • functionNames를 AppFunctionSearchSpec에 추가했습니다. (I95f53, b/494239238)
  • AppFunctionInstruction 주석을 추가했습니다. (I21120, b/488994214)
  • 런타임 등록된 앱 함수 서명을 선언하기 위해 AppFunctionSignature 주석 및 관련 상수를 추가했습니다. (I82a05, Ie2361, Ib6bb2)

버그 수정

  • AppFunctionSignatures의 생성된 XML에서 enabledByDefault를 생략합니다. (Ie2996, b/501032667)

버전 1.0.0-alpha09

2026년 5월 6일

androidx.appfunctions:appfunctions-*:1.0.0-alpha09가 출시되었습니다. 버전 1.0.0-alpha09에 포함된 커밋을 확인하세요.

API 변경사항

  • ExecuteAppFunctionRequest에서 AppInteractionAttribution을 허용합니다. (I70ad8, b/462092640)

버그 수정

  • SDK37에서 AppFunctionUriGrant 호환성 문제를 해결했습니다. (I21110, b/485613578)

버전 1.0.0-alpha08

2026년 3월 11일

androidx.appfunctions:appfunctions-*:1.0.0-alpha08가 출시되었습니다. 버전 1.0.0-alpha08에 포함된 커밋을 확인하세요.

새로운 기능

  • PendingIntent 외에 Parcelable 지원을 추가했습니다. (I8ab9f)
  • 플랫폼 요청 및 응답 간에 변환하는 API (Ifdf20)

API 변경사항

  • 스타일 가이드에 따른 매개변수 준수 (I69b2d)
  • 플랫폼 요청 및 응답 간에 변환하는 API를 추가했습니다. (Ifdf20, b/476047880)
  • AppFunctionManagerCompat의 이름을 AppFunctionManager로 바꿨습니다. (Id9a78, b/448372122)
  • PendingIntent의 get/set API를 삭제했습니다. (Ic7fd6, b/447530985)
  • Parcelable 지원을 추가하고 PendingIntent가 Parcelable로 표시되도록 이전했습니다. (I8ab9f, b/447530985)

버그 수정

  • Java 11 타겟을 사용하도록 라이브러리를 이동합니다. 즉, 생성된 바이트 코드는 Java 11 (클래스 파일 버전 55)이며 라이브러리를 사용하려면 디슈가링이 필요할 수 있습니다. (If4c2a, b/457821470)

버전 1.0.0-alpha07

2025년 11월 19일

androidx.appfunctions:appfunctions-*:1.0.0-alpha07가 출시되었습니다. 버전 1.0.0-alpha07에 포함된 커밋을 확인하세요.

API 변경사항

버그 수정

  • null이 아닌 필수 최상위 매개변수 문제를 해결했습니다. (Ic60fc, b/456717542)

버전 1.0.0-alpha06

2025년 11월 5일

androidx.appfunctions:appfunctions-*:1.0.0-alpha06가 출시되었습니다. 버전 1.0.0-alpha06에 포함된 커밋을 확인하세요.

새로운 기능

  • AppFunction 응답의 일부로 리소스 삽입 지원
  • AppFunctionUriGrant에서 FLAG_GRANT_PERSISTABLE_URI_PERMISSION 사용 허용

API 변경사항

버그 수정

  • null 허용 필수 필드를 무시하면 AppFunctionData를 구성할 때 실패하는 문제를 해결했습니다. (I52195)
  • List<PendingIntent>과 함께 AppFunction를 사용하면 컴파일 시간에 실패하는 문제를 해결했습니다. (Iebde7)
  • ByteArray의 메타데이터가 List<ByteArray>로 잘못 생성되는 문제를 해결했습니다. (I2e499)

버전 1.0.0-alpha05

2025년 10월 8일

androidx.appfunctions:appfunctions-*:1.0.0-alpha05가 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.

새로운 기능

  • AppFunctionData를 구성할 때 필수 필드가 제공되도록 적용합니다.
  • 제약 조건 값에 대해 AppFunctionData를 검증합니다.

API 변경사항

버그 수정

  • 필수 필드 AppFunctionsData 검사를 추가했습니다. (I36b16, b/394553462)
  • 인터페이스를 재정의할 때 매개변수 선택적 상태가 고려되지 않는 문제를 해결했습니다.
  • AppSearch는 앱 매니페스트에 지정된 상응하는 파일을 예상하므로 AppFunctions가 없더라도 빈 XML 파일을 생성합니다.

버전 1.0.0-alpha04

2025년 9월 10일

androidx.appfunctions:appfunctions-*:1.0.0-alpha04가 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

버그 수정

  • 출시 빌드의 R8 문제를 해결했습니다.

버전 1.0.0-alpha03

2025년 8월 13일

androidx.appfunctions:appfunctions-*:1.0.0-alpha03가 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.

새로운 기능

  • KDoc을 AppFunction 설명으로 사용합니다.
  • AppFunctionIntValueConstraint 및 AppFunctionStringValueConstraint 주석을 사용하여 각각 Int 및 String 유형의 값을 제한합니다.
  • 대규모 언어 모델의 자연어 설명과 에이전트 앱 내에 표시되는 사용자에게 표시되는 설명을 지정합니다.
  • AppFunctionUriGrant 클래스를 사용하여 앱 함수에서 반환된 URI에 권한을 자동으로 부여합니다.
  • AppFunctionTestRule을 사용하여 Robolectric 테스트를 작성하여 앱 함수 설정을 테스트합니다.

API 변경사항

  • AppFunctionStringValueConstraint를 추가했습니다. (I10e3f)
  • AppFunctionIntValueConstraint를 추가했습니다. (Ifda13)
  • AppFunctionPrimitiveTypeMetadata를 특정 데이터 유형 클래스로 리팩터링했습니다. (I1a3b2)
  • AppFunctionResponseMetadata에 설명 필드를 추가했습니다. (I2332b)
  • setAppFunctionEnabled API에서 권한 요구사항을 삭제했습니다. (I1b92a)
  • AppFunctionParameterMetadata에 설명 필드를 추가했습니다. (I40a67)
  • AppFunctionUriGrant를 추가했습니다. (I67ca9)
  • resolveAppFunctionAppMetadata API를 추가했습니다. (I17408)
  • @AppFunctionSerializable 주석에 isDescribedByKdoc을 추가했습니다. (Ie14e7)
  • AppFunctionDataTypeMetadata에 설명 필드를 추가했습니다. (I1bcac)
  • observeAppFunctions API에서 AppPackageMetadata를 반환합니다. (I68c7e)
  • AppFunctionMetadata에 설명 필드를 추가했습니다. (I060e2)
  • AppFunctionTestRule을 추가했습니다. (Id5ed0)
  • @AppFunction 주석에 isDescribedByKdoc을 추가했습니다. (Ia84d2)

버그 수정

  • AppFunctionManagerCompat는 U+ 기기만 지원합니다. (Ifa8d0)
  • AppFunction의 메타데이터 XML에 공유 직렬화 가능한 유형의 속성 설명을 추가했습니다. (I2aab2)
  • 생성된 AppFunction의 메타데이터 XML에 설명 요소를 추가했습니다. (Ie5bf6)

버전 1.0.0-alpha02

2025년 6월 4일

androidx.appfunctions:appfunctions:1.0.0-alpha02, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02, androidx.appfunctions:appfunctions-service:1.0.0-alpha02가 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.

새로운 기능

  • Android 16 API를 지원합니다.
  • 컴파일 시간에 매개변수화된 AppFunctionSerializable(s)를 더 잘 지원합니다.

API 변경사항

  • 에이전트가 자체 사전 정의된 함수 스키마를 정의할 수 있도록 AppFunctionSchemaDefinition API를 도입했습니다.

버그 수정

  • AppFunctions의 누락된 런타임 사용 설정 상태에 대한 오류 처리
  • AppFunctionComponentMetadata의 변경사항을 관찰하기 위한 observeAppFunctions API의 사소한 버그 수정
  • 추가 오류 로그

버전 1.0.0-alpha01

2025년 5월 7일

androidx.appfunctions:appfunctions:1.0.0-alpha01, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01, androidx.appfunctions:appfunctions-service:1.0.0-alpha01가 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

AppFunctions Jetpack 라이브러리는 android.app.appfunctions 플랫폼 API를 기반으로 빌드됩니다. 이 라이브러리는 앱의 기능을 어시스턴트에 노출하는 것을 간소화하고 어시스턴트가 앱의 노출된 함수와 상호작용할 수 있도록 합니다.

  • androidx.appfunctions:appfunctions: AppFunctions를 관리 (사용 설정/사용 중지)하고 상호작용 (검색/실행)하기 위한 핵심 클라이언트 API입니다.
  • androidx.appfunctions:appfunctions-service: 앱의 기능을 AppFunctions로 쉽게 노출하는 서비스 측 API입니다.
  • androidx.appfunctions:appfunctions-compiler: AppFunctions를 노출하는 데 필요한 코드를 생성하는 데 필요한 KSP 컴파일러입니다.