appfunctions

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

종속 항목 선언

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

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

Groovy

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha09"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha09"
    // 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-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha09")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha09")
    // 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-alpha09")
}

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

의견

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

새로운 문제 제출하기

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

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

버전 1.0

버전 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 변경사항

버그 수정

  • nullable 필수 필드를 무시하면 AppFunctionData를 구성할 때 실패하는 문제를 수정했습니다 (I52195).
  • AppFunction과 함께 List<PendingIntent>를 사용하면 컴파일 시간에 실패하는 문제를 수정했습니다 (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 설명으로 사용합니다.
  • AppFunctionIntValueConstraintAppFunctionStringValueConstraint 주석을 사용하여 각각 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 컴파일러입니다.