核心位置資訊按鈕

宣告依附元件

如要新增核心位置按鈕的依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

dependencies {
    implementation "androidx.core.locationbutton:locationbutton:"
    implementation "androidx.core.locationbutton:locationbutton-compose:"
    implementation "androidx.core.locationbutton:locationbutton-testing:"
}

dependencies {
    implementation("androidx.core.locationbutton:locationbutton:")
    implementation("androidx.core.locationbutton:locationbutton-compose:")
    implementation("androidx.core.locationbutton:locationbutton-testing:")
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

1.0 版本

1.0.0-alpha01 版

2026 年 6 月 17 日

發布 androidx.core.locationbutton:locationbutton:1.0.0-alpha01、androidx.core.locationbutton:locationbutton-compose:1.0.0-alpha01 和 androidx.core.locationbutton:locationbutton-testing:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。

新功能

AndroidX 實作項目的初始 Alpha 版，可讓以檢視區塊和 Compose 為基礎的應用程式，輕鬆要求一次性精確位置存取權。LocationButton對於搭載 Android 16 (API 36) 以下版本的裝置，程式庫會預設顯示標準位置存取權提示，自動提供回溯相容性。

API 變更

• 新增 LocationButton View，做為以 View 為基礎的應用程式的進入點。
• 新增 LocationButton 可組合函式，做為以 Compose 為基礎的應用程式進入點。
• 新增 OnPermissionResultListener、OnErrorListener 和 OnRequestPermissionsListener，用於處理回呼。
• 新增 TestLocationButtonProvider，方便應用程式測試依賴安全 LocationButton 的流程。