Back to Uni App

uni-location-tencent

src/uni_modules/uni-location-tencent/readme.md

2.3.33.3 KB
Original Source

uni-location-tencent

实现获取当前位置信息(使用腾讯定位SDK)功能。
API规范文档

Android 平台

  1. 申请腾讯地图key

申请网址

  1. 配置key到插件中

修改项目根目录下 AndroidManifest.xml <meta-data android:name="TencentMapSDK" android:value="您申请的Key" />

  1. 制作自定义基座运行后生效

iOS 平台

1.申请腾讯地图key

申请网址

2.配置key到插件中

将申请的key配置到插件目录下 app-ios -> info.plist 中 TencentLBSAPIKey 对应的值

xml
<key>TencentLBSAPIKey</key>
<string>您申请的Key</string>

3.配置访问位置权限描述信息

选中工程中的 manifest.json -> App权限配置 -> iOS隐私信息访问的许可描述,分别配置下列权限描述信息

  • NSLocationAlwaysUsageDescription
  • NSLocationWhenInUseUsageDescription
  • NSLocationAlwaysAndWhenInUseUsageDescription

4.制作自定义基座运行后生效

uts 语言介绍

uts,全称 uni type script,是一门跨平台的、高性能的、强类型的现代编程语言。

它可以被编译为不同平台的编程语言,如:

Android平台:编译为Kotlin
iOS平台:编译Swift
鸿蒙OS平台:编译为ArkTS
web平台/小程序:编译为JavaScript

uts 采用了与 ts 基本一致的语法规范,支持绝大部分 ES6 API。

但为了跨端,uts进行了一些约束和特定平台的增补。

过去在js引擎下运行支持的语法,大部分在uts的处理下也可以平滑的在kotlin和swift中使用。但有一些无法抹平,需要使用条件编译。

和uni-app的条件编译类似,uts也支持条件编译。写在条件编译里的,可以调用平台特有的扩展语法。

uts 插件介绍

UTS 插件是一种特定的 uni_modules 插件,其核心目的是允许 uni-app/uni-app x 开发者使用 UTS 语法来调用扩展 API(封装原生系统的API或三方SDK)。

UTS 插件的实现代码主要位于 utssdk 目录下,并按平台进行分离和组织:

目录/文件目标平台实现语言作用描述
utssdk/app-androidAndroidUTS, Kotlin, Java存放 UTS 插件在 Android 平台上的具体实现源码
utssdk/app-iosiOSUTS, Swift存放 UTS 插件在 iOS 平台上的具体实现源码
utssdk/app-harmonyHarmonyOS (鸿蒙)UTS, ArkTS存放 UTS 插件在 HarmonyOS 平台上的具体实现源码
utssdk/*.uts多平台共用UTS存放使用 UTS 语言编写的、可供 所有平台 共用的实现源码

参考文档