Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
fc02388c
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3200
Star
106
Fork
813
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
94
列表
看板
标记
里程碑
合并请求
70
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
94
Issue
94
列表
看板
标记
里程碑
合并请求
70
合并请求
70
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
fc02388c
编写于
10月 30, 2022
作者:
W
wanganxp
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
更新uts for android文档
上级
712c338a
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
21 addition
and
99 deletion
+21
-99
docs/plugin/uts-for-android.md
docs/plugin/uts-for-android.md
+21
-99
未找到文件。
docs/plugin/uts-for-android.md
浏览文件 @
fc02388c
##
写在最前
##
uts for Android
本文旨在
引导Android开发者,快速上手UTS插件开发
本文旨在
帮助Android开发者,快速上手UTS。
需要阅读者具备Android原生应用开发经验。
## 1 了解UTS插件是什么
`UTS插件`
是
`uni-app`
新型插件形式,拥有跨平台,高效率,易调试等优点。
[
详情
](
https://uniapp.dcloud.net.cn/plugin/uts-plugin.html#
)
`UTS插件`
是最新发布的
`uni-app`
新型插件形式,拥有跨平台,高效率,易调试等优点
[
更多介绍看这里
](
https://uniapp.dcloud.net.cn/plugin/uts-plugin.html#
)
对于Android开发者来说,我们需要了解的是
1 编译时:当我们在保存
`UTS`
源码文件时,IDE会同步将其编译为对应的Kotlin代码。
2 运行时:在真机运行/云打包时,这些编译后的kotlin源码也会成为apk的一部分
对于Android开发者来说,我们需要了解的是:
1.
编译时:当我们在保存
`UTS`
源码文件时,IDE会同步将其编译为对应的Kotlin代码。
2.
运行时:在真机运行/云打包时,这些编译后的kotlin源码也会成为apk的一部分
## 2 掌握UTS语法
开发UTS插件的第一步是掌握UTS语法
### 2.1 对于掌握kotlin语言者
因为UTS语法与kotlin很类似,可以从2.4 章节 开始阅读。
建议快速阅读后,在实践中掌握这UTS语法。
因为UTS语法与kotlin很类似,建议快速阅读后,在实践中掌握这UTS语法。
[
uts语法介绍
](
https://uniapp.dcloud.net.cn/tutorial/syntax-uts
)
。
### 2.2 对于仅掌握java语言者
与js相比,uts的语法和java更加类似。但是依然存在较大的差异,需要详细阅读2.3语法部分。
与js相比,uts的语法和java更加类似。
但是依然存在较大的差异,需要详细阅读2.3语法部分。
尽管开发UTS插件,并不要求一定掌握kotlin,但是鉴于
`UTS`
目前在android平台上,会编译为kotlin源码。
学习kotlin语言,方便排查问题和复杂功能实现
尽管开发UTS插件,并不要求一定掌握kotlin,但是鉴于
`UTS`
目前在android平台上,会编译为kotlin源码。学会kotlin语言,方便排查问题和复杂功能实现。
因此建议学习一下
2.3 章节 kotlin语法
因此建议学习一下
kotlin语法。
+
kotlin
[
https://kotlinlang.org/
](
https://kotlinlang.org/
)
+
kotlin for android
[
https://developer.android.com/kotlin
](
https://developer.android.com/kotlin
)
### 2.3 kotlin 语法部分
建议掌握kotlin语法,可以参考下面的文档
+
kotlin
[
文档
](
https://kotlinlang.org/
)
+
kotlin for android
[
文档
](
https://developer.android.com/kotlin
)
### 2.4 UTS语法部分
uts,全称 uni type script,是一门跨平台的、高性能的、强类型的现代编程语言。
> 它可以被编译为不同平台的编程语言,如:
>
> web平台,编译为JavaScript
>
> Android平台,编译为Kotlin
>
> iOS平台,编译Swift(暂未发布)
>
> uts 采用了与 ts 基本一致的语法规范,支持绝大部分 ES6 API。
uts语法详细介绍:
[
uts语法介绍
](
https://uniapp.dcloud.net.cn/tutorial/syntax-uts
)
---------------------------------
### 2.5 数据类型差异
### 2.3 数据类型差异
虽然 UTS 和 koltin 在数据类型上基本保持了一致,但是在部分场景下,还是会有差异,在此特别说明
...
...
@@ -129,8 +80,6 @@ uts语法详细介绍:[uts语法介绍](https://uniapp.dcloud.net.cn/tutorial/
但是在 调用
`onAppActivityRequestPermissionsResult`
函数监听权限申请结果时,明确要求使用此类型的参数
在原生环境中,应该这样写:
```
kotlin
...
...
@@ -145,7 +94,6 @@ onAppActivityRequestPermissionsResult(fun(requestCode: Number, permissions: Muta
为了适应这种情况,UTS 允许开发者使用原生平台的数据类型
`MutableList`
,来满足原生平台API对数据类型的要求:
```
ts
onAppActivityRequestPermissionsResult
((
requestCode
:
number
,
permissions
:
MutableList
<
string
>
,
grantResults
:
MutableList
<
number
>
)
=>
{
...
...
@@ -153,25 +101,19 @@ onAppActivityRequestPermissionsResult((requestCode: number,permissions: MutableL
```
## 3 Android原生环境配置 (目前版本暂不支持)
## 3 Android原生环境配置
对于Android项目来说,除了源码之外,还会涉及依赖,资源,配置等常见问题
本章节将会介绍,UTS插件开发环境中如何配置这些属性
注意:
+
1 本章节内的实例代码均取自Hello UTS
[
项目地址
](
https://gitcode.net/dcloud/hello-uts
)
+
2 本章节设计的配置,均需自定义基座后才能生效
### 3.1 配置AndroidManifest.xml
以hello UTS中的native-page插件中的配置文件为例:
示例文件在hello uts中的位置:
...
...
@@ -224,26 +166,20 @@ uts-nativepage -> uts.sdk.modules.utsNativepage
### 3.2 配置res资源
![](
https://native-res.dcloud.net.cn/images/uts/forAndroid/uts_android_res_folder.jpg
)
示例文件在hello uts中的位置:
~
\u
ni_modules
\u
ts-nativepage
\u
tssdk
\a
pp-android
\r
es
除了这里列出的layout,values目录外,还支持anim等所有android标准资源目录
除了这里列出的layout、values目录外,还支持anim等所有android标准资源目录
### 3.3 配置asset资源
以hello UTS中的uts-advance插件为例。
![
目录结构
](
https://native-res.dcloud.net.cn/images/uts/forAndroid/uts_android_assets_folder.jpg
)
关键代码:
```
ts
...
...
@@ -262,11 +198,6 @@ mediaPlayer.start();
~
\u
ni_modules
\u
ts-advance
\u
tssdk
\a
pp-android
\a
ssets
### 3.4 增加libs依赖资源
以Hello UTS项目下的uts-tencentgeolocation 插件为例
...
...
@@ -345,7 +276,7 @@ HX3.6.7 版本内置了以下依赖
至此我们认为你已经掌握了UTS语法,掌握了基本的Kotlin语法,掌握了UTS对于android资源的支持。
但是对于一个熟悉android开发的kotlin语言者来说,有很多常用的习惯发生了改变,我们会在这个章节特别指出
,
便于开发者加深认识。
但是对于一个熟悉android开发的kotlin语言者来说,有很多常用的习惯发生了改变,我们会在这个章节特别指出
,
便于开发者加深认识。
### 4.1 语法差异
...
...
@@ -354,7 +285,7 @@ HX3.6.7 版本内置了以下依赖
#### 4.1.1 可为空的语法标识
kotlin中可为空的语法统一为类型后加
`?`
,已
下面的代码为例
kotlin中可为空的语法统一为类型后加
`?`
,以
下面的代码为例
```
ts
// 一个可为空的字符串变量,变量名为user
...
...
@@ -378,7 +309,7 @@ let user?:string
`uts`
中对应
`var`
的变量类型为
`var/let`
推荐使用
`let`
因为只会在作用域内生效
,
需要慎用
`var`
,因为它具备有更大的作用范围
推荐使用
`let`
因为只会在作用域内生效
,
需要慎用
`var`
,因为它具备有更大的作用范围
#### 4.1.3 方法定义
...
...
@@ -399,14 +330,13 @@ uts中,需要区分全局方法、成员方法
}
```
```
u
ts
// 全局方法
方法
```
ts
// 全局方法
function
startListener
():
void
{
}
```
#### 4.1.4 extends
`kotlin`
中的: 继承操作符,需要用
`extends`
取代
...
...
@@ -428,9 +358,6 @@ class MediaContentObserver extends ContentObserver {
}
```
#### 4.1.5 非空断言
kotlin中的非空断言是
`!!`
,ts中是一个
`!`
...
...
@@ -473,8 +400,6 @@ user.setListener(Listener(){
});
```
目前版本UTS还不支持匿名内部类,需要显性的声明再新建
```
ts
...
...
@@ -540,13 +465,12 @@ class ScreenReceiver extends BroadcastReceiver{
#### 4.2.3 `UTS` 中下划线前缀的变量,有屏蔽未使用警告的含义
```
u
ts
```
ts
// IDE会提示 name,status,desc 变量未使用
onStatusUpdate
(
name
:
string
,
status
:
Int
,
desc
:
string
){
}
// 不会警告变量未使用
onStatusUpdate
(
_name
:
string
,
_status
:
Int
,
_desc
:
string
){
...
...
@@ -554,8 +478,6 @@ onStatusUpdate(_name:string, _status:Int, _desc:string){
```
## 5 常见问题(持续更新)
### 5.1 如何在UTS环境中,新建一个`activity`?
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录