Android Studio新手：如何将Location Manager替换为Fused Location Provider API？

嘿，我完全理解你作为Android Studio新手的困惑——Fused Location Provider API确实比传统的Location Manager在精度和效率上都要好太多，我会一步步带你完成集成，每一步都讲得明明白白！

第一步：添加必要的依赖 #

首先要确保你的项目引入了Google Play Services的定位库。打开你的**app/build.gradle (Module level)**文件，在dependencies块里添加以下代码：

dependencies {
    // 保留你原有的其他依赖...
    implementation 'com.google.android.gms:play-services-location:21.0.1'
}

添加后点击Sync Now同步项目即可。

第二步：配置定位权限 #

定位需要权限支持，分静态声明和动态申请两步：

1. 在AndroidManifest.xml里声明静态权限：

<manifest ...>
    <!-- 高精度定位权限（GPS+网络） -->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!-- 如果你的应用需要后台定位（Android 10+），额外添加这个权限 -->
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
    
    <application ...>
        <!-- 保留你原有的Activity声明 -->
    </application>
</manifest>

2. 动态申请权限（Android 6.0+必须）：
   Android 6.0以后，危险权限需要在运行时主动向用户申请，我们会在代码里处理这部分逻辑。

第三步：重构你的MainActivity代码 #

下面是整合了Fused Location Provider的完整代码示例，我保留了你提到的ContactDbAdapter，并替换掉旧的Location Manager逻辑：

import android.Manifest;
import android.content.pm.PackageManager;
import android.location.Location;
import android.os.Bundle;
import android.widget.Toast;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;

import com.google.android.gms.location.FusedLocationProviderClient;
import com.google.android.gms.location.LocationCallback;
import com.google.android.gms.location.LocationRequest;
import com.google.android.gms.location.LocationResult;
import com.google.android.gms.location.LocationServices;

public class MainActivity extends AppCompatActivity {
    ContactDbAdapter contactDbAdapter;
    // Fused Location核心客户端
    private FusedLocationProviderClient fusedLocationClient;
    // 定位请求配置（控制精度、更新频率）
    private LocationRequest locationRequest;
    // 定位更新回调（接收位置数据）
    private LocationCallback locationCallback;

    // 权限请求标识码
    private static final int LOCATION_PERMISSION_REQUEST_CODE = 100;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 初始化你原有的ContactDbAdapter
        contactDbAdapter = new ContactDbAdapter(this);

        // 1. 初始化FusedLocationProviderClient
        fusedLocationClient = LocationServices.getFusedLocationProviderClient(this);

        // 2. 配置高精度定位请求
        locationRequest = LocationRequest.create();
        // 设置优先级为最高精度（启用GPS、Wi-Fi、移动网络协同定位）
        locationRequest.setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY);
        // 设置定位更新间隔（比如30秒一次，可按需调整）
        locationRequest.setInterval(30000);
        // 设置最快更新间隔（避免过于频繁的更新耗电）
        locationRequest.setFastestInterval(10000);

        // 3. 初始化定位回调，处理位置更新结果
        locationCallback = new LocationCallback() {
            @Override
            public void onLocationResult(@NonNull LocationResult locationResult) {
                super.onLocationResult(locationResult);
                if (locationResult == null) {
                    Toast.makeText(MainActivity.this, "无法获取定位数据", Toast.LENGTH_SHORT).show();
                    return;
                }
                // 获取最新的高精度位置
                Location location = locationResult.getLastLocation();
                if (location != null) {
                    // 在这里处理定位数据，比如打印经纬度
                    String locationInfo = "高精度定位：\n纬度：" + location.getLatitude() + "\n经度：" + location.getLongitude();
                    Toast.makeText(MainActivity.this, locationInfo, Toast.LENGTH_LONG).show();
                    // 你也可以把定位数据存入ContactDbAdapter或做其他业务处理
                }
            }
        };

        // 4. 检查权限后启动定位
        checkPermissionAndStartLocation();
    }

    // 检查定位权限，有权限就启动定位，没权限就申请
    private void checkPermissionAndStartLocation() {
        if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            // 没有权限，向用户申请
            ActivityCompat.requestPermissions(
                    this,
                    new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                    LOCATION_PERMISSION_REQUEST_CODE
            );
            return;
        }
        // 有权限，启动持续定位更新
        fusedLocationClient.requestLocationUpdates(locationRequest, locationCallback, null);

        // 如果只需要单次高精度定位（不需要持续更新），可以替换成下面的代码：
        /*
        fusedLocationClient.getLastLocation()
                .addOnSuccessListener(location -> {
                    if (location != null) {
                        String locationInfo = "单次高精度定位：\n纬度：" + location.getLatitude() + "\n经度：" + location.getLongitude();
                        Toast.makeText(MainActivity.this, locationInfo, Toast.LENGTH_LONG).show();
                    } else {
                        Toast.makeText(MainActivity.this, "无法获取最新位置，请检查GPS是否开启", Toast.LENGTH_SHORT).show();
                    }
                });
        */
    }

    // 处理权限申请结果
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == LOCATION_PERMISSION_REQUEST_CODE) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                // 用户同意权限，启动定位
                checkPermissionAndStartLocation();
            } else {
                // 用户拒绝权限，提示无法获取高精度定位
                Toast.makeText(this, "需要定位权限才能获取高精度位置，请在设置中开启", Toast.LENGTH_LONG).show();
            }
        }
    }

    // 页面销毁时停止定位更新，避免不必要的耗电
    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (fusedLocationClient != null && locationCallback != null) {
            fusedLocationClient.removeLocationUpdates(locationCallback);
        }
    }
}

关键部分解释 #

• FusedLocationProviderClient：这是Fused Location API的核心工具类，负责发起定位请求和接收结果。
• LocationRequest：用来定义定位的规则，PRIORITY_HIGH_ACCURACY是保证高精度的关键，它会启用GPS模块。
• LocationCallback：当位置更新时，系统会通过这个回调把最新的位置数据传递给你，你可以在这里处理业务逻辑。
• 权限处理：必须确保用户授予ACCESS_FINE_LOCATION权限，否则无法获取GPS级别的高精度定位。

测试注意事项 #

1. 测试时请确保设备的GPS已开启，并且尽量在户外（室内GPS信号弱，精度会下降）。
2. 如果需要后台定位，记得在AndroidManifest里添加ACCESS_BACKGROUND_LOCATION，并在Android 11+上引导用户手动开启后台定位权限。
3. 不再需要定位时一定要调用removeLocationUpdates停止更新，避免持续耗电。

内容的提问来源于stack exchange，提问作者LJ Ca-ong