React Native跨iOS/Android可靠获取用户坐标的可await函数实现

我想要编写一个能100%可靠获取用户坐标的函数，目前的实现如下，但不确定是否完善。这个函数需要让调用者知晓位置权限状态，授权成功则返回坐标，否则返回权限状态。

我主要想学习两点：

1. 如何将该函数改造为支持await的形式；
2. 跨iOS和Android平台的标准实现方式，确保双平台运行一致。

现有代码：

function getUserLocation(callback: func) { 
  Permissions.check('location') 
    .then(response => { 
      if (response == 'authorized') { 
        navigator.geolocation.getCurrentPosition( 
          (location) => { 
            callback({ latitude: location.coords.latitude, longitude: location.coords.longitude }, response); 
          }, 
          (error) => { 
            callback(null); 
          }, 
          Platform.OS === 'android' ? null : {enableHighAccuracy: true, timeout: 100000, maximumAge: 1000} 
        ); 
      } else { 
        callback(null, response); 
      } 
    }) 
}

一、改造为支持await的异步函数 #

要把回调式的函数改成可await的，核心是将整个逻辑包装在Promise里，这样就能用async/await语法调用，代码可读性和维护性都会提升。这里要覆盖所有成功、失败和权限分支：

async function getUserLocation() {
  try {
    // 先检查权限状态
    const permissionStatus = await Permissions.check('location');
    
    // 未授权直接返回状态
    if (permissionStatus !== 'authorized') {
      return { location: null, permissionStatus };
    }

    // 把getCurrentPosition包装成Promise，适配await语法
    const position = await new Promise((resolve, reject) => {
      navigator.geolocation.getCurrentPosition(
        resolve,
        reject,
        getGeolocationOptions() // 统一跨平台配置，后面详细说明
      );
    });

    // 成功获取位置，返回坐标和权限状态
    return {
      location: {
        latitude: position.coords.latitude,
        longitude: position.coords.longitude
      },
      permissionStatus
    };
  } catch (error) {
    // 处理定位失败或权限检查异常
    let errorMessage = '';
    switch(error.code) {
      case error.PERMISSION_DENIED:
        errorMessage = '位置权限被拒绝';
        break;
      case error.POSITION_UNAVAILABLE:
        errorMessage = '无法获取当前位置';
        break;
      case error.TIMEOUT:
        errorMessage = '获取位置超时';
        break;
      default:
        errorMessage = '获取位置失败：' + error.message;
    }
    return { location: null, permissionStatus: 'authorized', error: errorMessage };
  }
}

// 调用示例
async function useUserLocation() {
  const { location, permissionStatus, error } = await getUserLocation();
  if (permissionStatus !== 'authorized') {
    console.log('位置权限状态:', permissionStatus);
  } else if (error) {
    console.log('定位失败原因:', error);
  } else {
    console.log('当前坐标:', location);
  }
}

二、跨iOS/Android的标准实现（确保双平台一致性） #

你的原代码针对双平台用了不同的定位配置，容易导致行为不一致。要让双平台表现统一，需要注意以下几个关键点：

1. 统一定位配置参数

不要给Android传null，而是基于双平台通用的参数做微调，避免行为差异：

function getGeolocationOptions() {
  const baseOptions = {
    enableHighAccuracy: true, // 双平台都支持，开启后优先用GPS/高精度定位
    timeout: 15000, // 统一设置15秒超时，避免用户长时间等待（原100秒太长）
    maximumAge: 0 // 不使用缓存位置，确保获取最新坐标
  };

  // Android上高精度模式依赖GPS，室内可能定位慢，可根据场景调整
  if (Platform.OS === 'android') {
    return {
      ...baseOptions,
      // 如果不需要极致精度，可设enableHighAccuracy为false，依赖网络定位提升速度
    };
  }

  return baseOptions;
}

2. 完善全场景权限处理

原代码只处理了authorized状态，但双平台还有denied、restricted（iOS特有）、never_ask_again（Android特有）、undetermined（首次未授权）等状态，需要统一覆盖：

async function getUserLocation() {
  try {
    let permissionStatus = await Permissions.check('location');
    
    // 处理未确定状态：主动请求权限
    if (permissionStatus === 'undetermined') {
      const requestResult = await Permissions.request('location');
      permissionStatus = requestResult;
    }

    // 处理所有非授权状态
    const nonAuthorizedStatuses = ['denied', 'restricted', 'never_ask_again'];
    if (nonAuthorizedStatuses.includes(permissionStatus)) {
      return { location: null, permissionStatus };
    }

    // 后续定位逻辑...
  } catch (error) {
    return { location: null, permissionStatus: 'error', error: error.message };
  }
}

3. 平台必备配置（确保定位能正常触发）

• iOS: 必须在Info.plist中添加权限描述，比如NSLocationWhenInUseUsageDescription（前台定位）或NSLocationAlwaysAndWhenInUseUsageDescription（前后台定位），否则权限请求会直接失败。
• Android: 需要在AndroidManifest.xml中添加对应权限：
  • 高精度定位：<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  • 粗略定位：<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  • Android 10+后台定位：<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

这些配置是双平台定位功能正常工作的前提，一定要配置正确。

内容的提问来源于stack exchange，提问作者1110