提交 00a1a017 编写于 作者: W wanganxp

原生sdk修缮

上级 8fb59663
## 简介 ## 简介
uni-app x离线SDK是离线开发工具包,是把App运行环境封装为原生开发调用接口,开发者可以在自己的 Android 及 iOS 原生开发环境配置工程使用,包括 Android离线开发SDK 及 iOS离线开发SDK。 uni-app x 原生SDK是为原生工程师提供的开发工具包,把uni-app x的runtime封装为原生开发调用的接口。开发者可以在自己的 Android 及 iOS 原生开发环境配置工程使用,包括 Android原生SDK 及 iOS原生SDK。
## 功能 ## 功能
uni-app x离线SDK主要用于App本地离线打包 uni-app x 原生SDK主要用于既有的原生项目,通过集成uni-app x sdk,实现跨平台提升效率和渐进式迁移,让部分页面或应用通过uni-app x来实现。
当然本sdk也可以用于App本地离线打包,相当于新建一个空的原生项目,把uni-app x sdk集成进去然后本地打包。
- App离线打包: - App离线打包:
...@@ -10,6 +12,3 @@ uni-app x离线SDK主要用于App本地离线打包 ...@@ -10,6 +12,3 @@ uni-app x离线SDK主要用于App本地离线打包
+ [Android平台App本地离线打包](use/android.md) + [Android平台App本地离线打包](use/android.md)
+ iOS平台App本地离线打包(暂不支持) + iOS平台App本地离线打包(暂不支持)
## 注意
+ `uni-app``5+ App`离线打包需要参考[App离线打包](/AppDocs/README.md)
\ No newline at end of file
...@@ -12,4 +12,4 @@ ...@@ -12,4 +12,4 @@
### 导入Android项目 ### 导入Android项目
[将资源导入Android原生项目](/uniappxDocs/use/android.md) [将资源导入Android原生项目](../use/android.md)
\ No newline at end of file \ No newline at end of file
...@@ -9,24 +9,17 @@ ...@@ -9,24 +9,17 @@
## 新建项目 ## 新建项目
点击android studio 左上角的File->New->New Project... android studio中新建项目,模板选择`No Activity`。下一步选语言kotlin和Build configuration language,如下图:
![](../image/new_project.jpg)
模板选择`No Activity`,点击`Next`
![](../image/create_project.jpg) ![](../image/create_project.jpg)
`Name`建议与manifest.json中的`name`字段一致。
`Package name`作为应用标志,涉及申请第三方平台账号,一般情况下不建议修改,包名一般设置反向域名,如:io.dcloud.HBuilder。
点击`Finish`完成创建。
**注意** **注意**
- `Language` 一定要选择`Kotlin` - `Language` 一定要选择`Kotlin`
- uni-app x最低支持版本为21,`Minimum SDK`需要选择21及以上的版本。 - uni-app x最低支持版本为21,`Minimum SDK`需要选择21及以上的版本。
- `Build configuration language`建议选择`Groovy DSL(build.gradle)`。以下教程均按照此模式进行。 - `Build configuration language`建议选择`Groovy DSL(build.gradle)`。以下教程均按照此模式进行。
- `Name`建议与manifest.json中的`name`字段一致。
- `Package name`作为应用标志,涉及申请第三方平台账号,一般情况下不建议修改,包名一般设置反向域名。
## 工程配置 ## 工程配置
...@@ -292,7 +285,7 @@ xml文件配置成功之后,修改AndroidManifest.xml中`android:name`为`io.d ...@@ -292,7 +285,7 @@ xml文件配置成功之后,修改AndroidManifest.xml中`android:name`为`io.d
应用名称默认定义为`app_name`字段,位于`app->src->main->res->values->strings.xml`。该值为安装到手机上桌面显示的应用名称,建议与manifest.json中name(基础配置中的应用名称)对应。 应用名称默认定义为`app_name`字段,位于`app->src->main->res->values->strings.xml`。该值为安装到手机上桌面显示的应用名称,建议与manifest.json中name(基础配置中的应用名称)对应。
### 拷贝资源文件 ### 拷贝资源文件
1. [导出uni-app x项目的资源文件](/uniappxDocs/export/export.md) 1. [导出uni-app x项目的资源文件](../export/export.md)
2. 将app-android目录下与appid对应的目录拷贝到主项目的`assets/apps`目录下 2. 将app-android目录下与appid对应的目录拷贝到主项目的`assets/apps`目录下
![](../image/app_assets.png) ![](../image/app_assets.png)
...@@ -397,7 +390,7 @@ dependencies { ...@@ -397,7 +390,7 @@ dependencies {
如果不包含config.json文件,可以[跳过](#复制资源)此章节。 如果不包含config.json文件,可以[跳过](#复制资源)此章节。
[config.json配置及参考文档。](https://doc.dcloud.net.cn/uni-app-x/plugin/uts-plugin.html#config-json) [config.json配置及参考文档。](../../plugin/uts-plugin.md#androidconfigjson)
如果config.json中不存在下面示例中的任一字段,直接忽略即可。 如果config.json中不存在下面示例中的任一字段,直接忽略即可。
...@@ -579,7 +572,7 @@ dependencies { ...@@ -579,7 +572,7 @@ dependencies {
## 配置内置模块 ## 配置内置模块
根据`unpackage/resource/{appid}/manifest.json`的配置,添加[内置模块的配置](/uniappxDocs/modules/android/others.md) 根据`unpackage/resource/{appid}/manifest.json`的配置,添加[内置模块的配置](../modules/android/others.md)
以下模块可以忽略配置: 以下模块可以忽略配置:
- uni-exit - uni-exit
......
...@@ -244,7 +244,7 @@ Android原生应用清单文件,建议只保存UTS插件内置的清单文件 ...@@ -244,7 +244,7 @@ Android原生应用清单文件,建议只保存UTS插件内置的清单文件
除了插件下有AndroidManifest.xml,项目下也有。注意2者的区别。一般使用者的配置不放在插件下,而放在自己的项目下。项目下配置[详见](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android) 除了插件下有AndroidManifest.xml,项目下也有。注意2者的区别。一般使用者的配置不放在插件下,而放在自己的项目下。项目下配置[详见](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android)
##### config.json ##### config.json@androidconfigjson
uts插件在Android平台的原生层配置文件,可以在其中配置依赖仓储等gradle相关内容。 uts插件在Android平台的原生层配置文件,可以在其中配置依赖仓储等gradle相关内容。
```json ```json
...@@ -419,7 +419,7 @@ iOS平台原生 entitlements 文件配置,云端打包时会将配置信息合 ...@@ -419,7 +419,7 @@ iOS平台原生 entitlements 文件配置,云端打包时会将配置信息合
</plist> </plist>
``` ```
##### config.json ##### config.json@iosconfigjson
uts插件在iOS平台的其它原生配置文件,可以在其中配置依赖的系统库等信息 uts插件在iOS平台的其它原生配置文件,可以在其中配置依赖的系统库等信息
```json ```json
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册