Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

appfunctions

앱이 AI 어시스턴트와 기능 및 데이터를 공유하여 기기에서 직접 작업을 검색하고 실행하여 사용자 요청을 처리할 수 있도록 지원합니다.

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2026년 9월 23일	-	-	-	1.0.0-alpha12

종속 항목 선언

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

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

Groovy

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

Kotlin

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

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

의견

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

새로운 문제 제출하기

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

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

버전 1.0

버전 1.0.0-alpha12

2026년 9월 23일

androidx.appfunctions:appfunctions:1.0.0-alpha12, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12 및 androidx.appfunctions:appfunctions-testing:1.0.0-alpha12이 출시되었습니다. 버전 1.0.0-alpha12에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

AppFunctionData#serialize 호출자가 메타데이터를 제공해야 합니다. (I61eca)
기존 Class 기반 오버로드 외에 인라인 구체화된 getHandleAppFunctionRequestAdapter를 추가합니다. (Ic1b4e)
AppFunctionContext 및 AppFunctionConfiguration 삭제 (I9dd8f)
activityId을 ExecuteAppFunctionRequest에 추가했습니다. (I6ac86)
registerAppFunction, registerAppFunctions, RegisterAppFunctionRequest, CallbackAppFunction를 @ExperimentalAppFunctionsApi로 추가합니다. (Idb2ca)
AppFunctionMetadata 및 AppFunctionSearchSpec에 scope 추가 (I4344c)
AppFunctionUriValueConstraint을 공개 API로 추가 (I75070)
AppFunctionPackageMetadata 생성자 업데이트 (I096f7)

버전 1.0.0-alpha11

2026년 8월 26일

androidx.appfunctions:appfunctions:1.0.0-alpha11, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha11 및 androidx.appfunctions:appfunctions-testing:1.0.0-alpha11이 출시되었습니다. 버전 1.0.0-alpha11에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

@AppFunctionSignature을 실험용 공개 API로 추가 API는 Jetpack을 통한 동적 AppFunction 등록을 지원합니다. (I72e23, b/501032667)
AppFunctionState 및 AppFunctionManager#getAppFunctionStates 추가 이 함수는 AppFunctionMetadata#isEnabled를 대체합니다. 이제 메타데이터가 상태에서 완전히 분리되었습니다. (I8e490, b/494238383)
Add getAppFunctionActivityStates. (I41093, b/542075714)
사이드카와 함께 작동하는 앱을 지원하기 위해 ExtensionsAppFunctionService 추가 (I7cf10, b/524941402)
플랫폼 API와 일치하도록 observeAppFunctions API 업데이트 (Ifa6fb, b/494238381)

버그 수정

OOBE 중에 setAppFunctionEnabled를 호출할 때 런타임 메타데이터가 누락되어 앱이 비정상 종료될 수 있는 문제 수정 (Ibe229, b/536750020)
메타데이터가 동일한 정보 소스에서 제공될 때까지 AppFunctionData#serialize API를 사용할 때 데이터 유효성 검사를 일시적으로 사용 중지 (I6c95, b/545200019)

버전 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 주석은 AppFunctionServiceEntryPoint로 주석이 지정된 AppFunctionService 내에 선언해야 합니다. (Idc5d5, b/463909015)
AppFunction 및 AppFunctionConfiguration API를 이동했습니다 . AppFunctionConfiguration는 AppFunctionServiceEntryPoint로 대체되므로 향후 출시에서 삭제될 예정입니다. (Iaff23, I4cf3e, b/517876475)
콜백을 지원하도록 AppFunctionService API 업데이트 (I6e0d7, b/519880977)
searchAppFunctions API 추가 (I8c0f9, I1fa27, b/494239238)
AppFunctionSearchSpec에 functionNames를 추가했습니다. (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 변경사항

AppFunction 지원 중단 지원 (I39229, b/454661174)

버그 수정

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

ResourceHolder API 추가 (I08c1c, b/447530724)
AppFunctionTextResource API 추가 (I7d54f, b/447530724)
AppFunctionOneOfTypeMetadata API 추가 (I12c67, b/449915612)
서비스 API에서 호환성 서픽스 삭제 (Ib9291, b/449797980, b/449797980)
AllOfType에서 AppFunctionData 빌드 지원 (Ib1176, b/447535093)
AppFunctionData에 Parcelable API 가져오기/설정 추가 (I3aec7, b/447530985)

버그 수정

null 허용 필수 필드를 무시하면 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 변경사항

AppFunctionService 호환성 API 추가 (I2f1b1, b/445388953)

버그 수정

필수 필드 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 컴파일러입니다.