跳到主要内容

基础

常用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-PLUSApp
APP-PLUS-NVUEApp nvue
H5H5
MP-WEIXIN微信小程序
MP-ALIPAY支付宝小程序
MP-BAIDU百度小程序
MP-TOUTIAO字节跳动小程序
MP-QQQQ小程序
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)​

  1. 获取Apple开发者账号: 您需要一个Apple开发者账号,以便上传应用到App Store。这通常需要一些费用。
  2. 准备应用信息: 在App Store Connect(苹果的开发者平台)中设置应用的信息,包括名称、描述、图标、截图等。
  3. 生成IPA文件: 生成打包好的IPA文件。
  4. 上传应用: 登录到App Store Connect,创建一个新的应用记录,然后将生成的IPA文件上传到这个应用记录中。
  5. 填写元数据: 填写应用的元数据,包括描述、关键字、类别等。
  6. 设置定价和发布: 设置应用的定价和发布计划。
  7. 提交审核: 提交您的应用进行审核。审核可能需要一些时间,若通过审核,则应用将会在App Store中可见

上传到Google Play Store(Android)​

  1. 获取Google Play开发者账号: 您需要一个Google Play开发者账号,以便上传应用到Google Play Store。这通常需要一些费用。
  2. 准备应用信息: 在Google Play Console(谷歌的开发者平台)中设置应用的信息,包括名称、描述、图标、截图等。
  3. 生成APK文件: 使用适用的工具,生成打包好的APK文件。
  4. 上传应用: 登录到Google Play Console,创建一个新的应用记录,然后将生成的APK文件上传到这个应用记录中。
  5. 填写元数据: 填写应用的元数据,包括描述、关键字、类别等。
  6. 设置定价和发布: 设置应用的定价和发布计划。
  7. 提交审核: 提交您的应用进行审核。在谷歌的审核过程中,通常会检查应用是否遵循规定,并进行一些测试,如安全性测试等