基础
常用api
存储相关
-
uni.setStorageSync 、uni.setStorage
- 将数据同步/异步存储在本地缓存中指定的 key 中
-
将数据异步存储在本地缓存中指定的 key 中
-
uni.getStorage
- 从本地缓存中异步获取指定 key 对应的内容
-
uni.removeStorageSync、uni.removeStorage
- 同步/异步移除数据
系统相关
- uni.getSystemInfoSync()
- 获取系统信息
- uni.onMemoryWarning
- 监听内存不足告警事件
界面相关
-
uni.pageScrollTo
- 将页面滚动到目标位置,也可以指定滚动到某个元素的位置
-
uni.createSelectorQuery()
- 返回一个
SelectorQuery对象实例,可获取节点相关信息
- 返回一个
导航相关
- uni.navigateTo
- 保留当前页面,跳转到应用内的某个页面
- uni.switchTab
- 跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面
- uni.redirectTo
- 关闭当前页面,跳转到应用内的某个页面
- uni.reLaunch
- 关闭所有页面,打开到应用内的某个页面
- uni.navigateBack
- 关闭当前页面,返回上一页面或多级页面
常用库
manifest.json文件
manifest.json 文件是应用的配置文件,用于指定应用的名称、图标、权限等
条件注释编译
- 大量写 if else,会造成代码执行性能低下和管理混乱, 以及增加打包体积
- 在 C 语言中,通过 #ifdef、#ifndef 的方式,为 windows、mac 等不同 os 编译不同的代码。 uni-app 参考这个思路,为 uni-app 提供了条件编译手段
条件编译是用特殊的注释作为标记,在编译时根据这些特殊的注释,将注释里面的代码编译到不同平台。
写法: 以 #ifdef 或 #ifndef 加 %PLATFORM% 开头,以 #endif 结尾。
#ifdef:if defined 仅在某平台存在#ifndef:if not defined 除了某平台均存在%PLATFORM%:平台名称
| 条件编译写法 | 说明 |
|---|---|
| #ifdef APP-PLUS 需条件编译的代码 #endif | 仅出现在 App 平台下的代码 |
| #ifndef H5 需条件编译的代码 #endif | 除了 H5 平台,其它平台均存在的代码(注意if后面有个n) |
| #ifdef H5 || MP-WEIXIN 需条件编译的代码 #endif | 在 H5 平台或微信小程序平台存在的代码(这里只有||,不可能出现&&,因为没有交集) |
%PLATFORM% 可取值如下:
| 值 | 平台 |
|---|---|
| APP-PLUS | App |
| APP-PLUS-NVUE | App nvue |
| H5 | H5 |
| MP-WEIXIN | 微信小程序 |
| MP-ALIPAY | 支付宝小程序 |
| MP-BAIDU | 百度小程序 |
| MP-TOUTIAO | 字节跳动小程序 |
| MP-QQ | QQ小程序 |
| MP | 微信小程序/支付宝小程序/百度小程序/字节跳动小程序/QQ小程序 |
应用打包
- 使用ios打包, 需要安装相关证书
.ipa文件是 iOS 应用的安装包文件,通常用于在 iPhone、iPad 等 iOS 设备上安装应用
.apk文件是 Android 应用的安装包文件,用于在 Android 设备上安装应用。
HBuilderX
打包IOS应用
- 1、在HBuilderX工具栏,点击发行,选择原生app-云端打包
- 2、选择 "原生App-云打包"。
- 3、在弹出的窗口中,选择 "iOS" 作为目标平台。
- 4、配置应用信息,包括 App 名称、版本号等。
- 5、配置签名信息,可以选择使用证书或者云证书进行签名。
- 6、点击 "确定" 开始打包。HBuilderX 会上传应用源码和配置到云端进行编译。
- 7、完成编译后,你可以下载生成的 .ipa 文件上传到 App Store 进行发布
打包 Android 应用
- 1、打开 HBuilderX,加载你的 UniApp 项目。
- 2、在左侧导航栏中,找到并展开 "发行"(Release)选项。
- 3、选择 "原生App-云打包"。
- 4、在弹出的窗口中,选择 "Android" 作为目标平台。
- 5、配置应用信息,包括包名、版本号等。
- 6、配置签名信息,可以选择使用证书或者云证书进行签名。如果是自签名,需要提供 keystore 文件。
- 7、配置其他打包参数,如构建模式、屏幕方向等。
- 8、点击 "确定" 开始打包。HBuilderX 会上传应用源码和配置到云端进行编译。
- 9、完成编译后,你可以下载生成的 .apk 文件,然后将其安装到 Android 设备上进行测试,或者上传到应用商店进行发布
打包的ipa/apk文件,如何上传到商店
uniapp打包好的ipa文件,需要上架到appstore,用户才能通过app store下载使用,因此我们需要将ipa上架到appstore.
上传到App Store(iOS)
- 获取Apple开发者账号: 您需要一个Apple开发者账号,以便上传应用到App Store。这通常需要一些费用。
- 准备应用信息: 在App Store Connect(苹果的开发者平台)中设置应用的信息,包括名称、描述、图标、截图等。
- 生成IPA文件: 生成打包好的IPA文件。
- 上传应用: 登录到App Store Connect,创建一个新的应用记录,然后将生成的IPA文件上传到这个应用记录中。
- 填写元数据: 填写应用的元数据,包括描述、关键字、类别等。
- 设置定价和发布: 设置应用的定价和发布计划。
- 提交审核: 提交您的应用进行审核。审核可能需要一些时间,若通过审核,则应用将会在App Store中可见
上传到Google Play Store(Android)
- 获取Google Play开发者账号: 您需要一个Google Play开发者账号,以便上传应用到Google Play Store。这通常需要一些费用。
- 准备应用信息: 在Google Play Console(谷歌的开发者平台)中设置应用的信息,包括名称、描述、图标、截图等。
- 生成APK文件: 使用适用的工具,生成打包好的APK文件。
- 上传应用: 登录到Google Play Console,创建一个新的应用记录,然后将生成的APK文件上传到这个应用记录中。
- 填写元数据: 填写应用的元数据,包括描述、关键字、类别等。
- 设置定价和发布: 设置应用的定价和发布计划。
- 提交审核: 提交您的应用进行审核。在谷歌的审核过程中,通常会检查应用是否遵循规定,并进行一些测试,如安全性测试等