更新记录

1.1.8（2025-04-11）

修改文档

1.1.7（2025-03-22）

优化

1.1.6（2025-03-17）

优化ios

平台兼容性

uni-app

uni-app x

xtf-gpslocation

android ios 原生gps 定位

长期维护，有任何问题在插件群联系

插件测试使用方法

1. 选择试用，绑定要试用的项目appid，

2. 选择后下载到对应的本地项目，

3. 按照文档 -》把插件引入项目（即 import { KeepLive } from '@/uni_modules/android-keeplive' 需要先引入），

4. 发布-》云打包-》选择制作基座-》打包等基座制作完成

5. 运行 -》 运行到手机或模拟器-》运行到Androidapp基座-》选择使用自定义基座运行-》选择手机-》运行

若长期无法获取到定位，请到室外进行定位 室内大概率无gps 信号

推荐作者保活插件一起使用

uniappx

复制代码import { isProviderEnabled, openLocSetting,  onStartLocs,LocData,stop,requestBackgroundLocPer,getLastLocations,LocationData} from "@/uni_modules/xtf-gpslocation"

var on=isProviderEnabled();// 是否开启gps
if(!on){
    openLocSetting();// 打开gps 设置
}
requestBackgroundLocPer();// 申请后台定位权限 无权限则申请，有权限则直接跳过

// 获取上次定位
getLastLocations(function(loc:LocationData){
    console.log(loc)
})

onStartLoc({
    backgroud:true,
} as LocData,function(loc:LocationData){
    console.log(loc)
})
// stop(true);// 停止定位   参数为是否移除通知

uniapp

复制代码import { isProviderEnabled, openLocSetting,  onStartLocs,stop,requestBackgroundLocPer,getLastLocations} from "@/uni_modules/xtf-gpslocation"

var on=isProviderEnabled();// 是否开启gps
if(!on){
    openLocSetting();// 打开gps 设置
}

requestBackgroundLocPer();// 申请后台定位权限 无权限则申请，有权限则直接跳过
// 获取上次定位
getLastLocations(function(loc){
    console.log(loc)
})

onStartLoc({
    backgroud:true,
},function(loc){
    console.log(loc)
})
// stop(true);// 停止定位   参数为是否移除通知

请求参数 LocData

复制代码 export type LocData={
     title?:string,// 通知栏标题
     content?:string,// 通知栏内容
     notifationIconName?:string, // 通知栏icon名称  插件目录 /app-android/res/drawable/
     time?:number, // 定位时间间隔，默认0  为仅定位一次 时间为毫秒
     distance?:number,// 定位位置间隔距离  // 默认0
     backgroud?:boolean,// 是否是后台定位,
     getLastFast?:boolean,// 是否先获取上次定位 之后在返回新的定位 // 默认true
};

返回参数 LocationData

复制代码 export type LocationData={
     msg:string,// 消息
    type:number,//  0 是上一次的  1 是最新的  2 定位失败
    lat:number, //经度
    lng:number,//纬度
    speed:number,//速度
    altitude:number,//海拔
};

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS