appfunctions

  
TODO
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2025년 11월 5일 - - - 1.0.0-alpha06

종속 항목 선언

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

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

Groovy

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

Kotlin

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

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

의견

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

새로운 문제 제출하기

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

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

버전 1.0

버전 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)
  • 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 설명으로 사용
  • 각각 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 컴파일러입니다.