文档

外观

Cordova ​

Meteor 允许开发人员使用 HTML、CSS 和 JavaScript 等 Web 技术构建移动应用程序，同时还可以访问原生移动功能。这种集成是通过 Apache Cordova 实现的。

Cordova 应用程序运行在 Web 视图中，这就像一个没有 UI 的浏览器。不同的浏览器引擎对 Web 标准的实现和支持各不相同。这意味着您的应用程序使用的 Web 视图会极大地影响其性能和可用功能。（有关跨浏览器和版本的受支持功能的详细信息，请查看 caniuse.com。）

有一个 Meteor Cordova 指南 可供使用，其中提供了 Meteor Cordova 项目的高级配置详细信息。在更新新文档中的信息时，请随时参考它。

本节将总结为 Meteor Cordova 开发设置环境、管理开发和生成用于商店上传的原生工件所需的步骤。

预安装 ​

在开始之前，请确保您的开发环境满足以下要求

Android ​

Java ​

对于 Android 开发，Cordova 需要 JDK。

sh
# On Debian/Ubuntu:
sudo apt-get update
sudo apt-get install openjdk-17-jdk

# On Mac OSX
brew install openjdk@17
sudo ln -sfn $(brew --prefix)/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

# using sdkman
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install java 17
sdk default java 17

java -version  # Verify installation

通过将其添加到 ~/.bashrc 或 ~/.zshrc 来确保设置了 JAVA_HOME 环境变量

sh
export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java))))
export PATH=$JAVA_HOME/bin:$PATH

运行 echo $JAVA_HOME 以检查当前的 Java 版本。如果它不正确，请通过查找 Java 安装位置手动设置正确的路径。

Android SDK ​

对于 Android 构建，您将需要 Android SDK。您可以通过 Android Studio 安装它。

安装 Android Studio 后，转到**SDK 管理器**并安装所需的 SDK 包。最低要求版本为 Android SDK 34。也请安装 Android SDK 命令行工具（最新）。

通过将其添加到 ~/.bashrc 或 ~/.zshrc 来确保设置了 ANDROID_HOME 环境变量

sh
export ANDROID_HOME=$HOME/Library/Android/sdk
export ANDROID_SDK_ROOT=${ANDROID_HOME}
export PATH=$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$PATH

Gradle ​

如果找不到 Gradle，请使用以下命令安装它：

sh
# On Mac OSX:
brew install gradle

# On Debian/Ubuntu:
sudo apt-get install gradle

# using sdkman
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install gradle 8.7

gradle --version  # Verify installation

iOS ​

对于 iOS 开发，您将需要 Xcode（仅限 macOS）。

从 App Store 安装 Xcode。

安装后，请确保已安装**命令行工具**

sh
xcode-select --install

下载和安装完成后，您需要接受许可协议。首次打开 Xcode 时，将出现一个包含协议的对话框，供您查看和接受。然后您可以关闭 Xcode。或者在命令行上使用下一个命令。

sh
sudo xcodebuild -license accept

此外，安装 CocoaPods，这是管理 iOS 项目依赖项所必需的

sh
sudo gem install cocoapods

开发 ​

设置好所有先决条件后，您可以快速运行移动项目。

添加平台 ​

要开发移动应用程序，您需要为 Cordova 添加平台（iOS 和 Android）

sh
# Android
meteor add-platform android

# iOS (only works on macOS)
meteor add-platform ios

运行模拟器 ​

您现在可以使用 meteor run 命令在开发模式下运行应用程序

sh
# Android
meteor run android

# iOS (only works on macOS)
meteor run ios

运行物理设备 ​

要在物理设备上运行，请确保设备已通过 USB 连接

sh
# Android
meteor run android-device

# iOS (only works on macOS)
meteor run ios-device

打开 IDE ​

使用 Cordova 设置 Meteor 项目后，您可能希望直接使用**Android Studio**或**XCode**运行或调试移动应用程序。这对于高级调试、自定义配置或访问特定平台工具很有用

在 Android Studio 中打开 ​

  1. 打开**Android Studio**
  2. 点击**“打开现有的 Android Studio 项目”**
  3. 导航到您的 Meteor 项目目录
    .meteor/local/cordova-build/platforms/android/
  4. 打开项目

现在您可以使用**Android Studio**管理您的应用程序，包括连接到物理设备或模拟器、查看代码、使用调试工具等等。

在 XCode 中打开 ​

  1. 打开**XCode**
  2. 导航到 Meteor 项目目录
    .meteor/local/cordova-build/platforms/ios/
  3. 打开项目或 .xcworkspace 文件

现在您可以使用**XCode**管理您的应用程序，包括连接到物理设备或模拟器、查看代码、使用调试工具等等。

生产 ​

构建 ​

开发完成后，您需要构建实际的移动应用程序（Android 的 APK/AAB 或 iOS 的 IPA）以分发给用户或上传到应用商店。

sh
meteor build ../build-output --server=https://your-server-url.com

分发 ​

使用 Meteor 构建 Cordova 项目后，您可以使用 Android 的**Android Studio**和 iOS 的**Xcode**来处理签名和创建最终工件。

Android ​

  1. 打开**Android Studio**
  2. 点击**“打开现有的 Android Studio 项目”**
  3. 导航到您的 Meteor 项目目录
    ./build-output/android/project
  4. 打开项目
  5. 转到**构建 > 生成签名捆绑包/APK**
  6. 按照提示创建或使用密钥库，配置签名并构建 APK/ABB。
  7. 使用 Google Play Console 将 APK/ABB 上传到 Play 商店

iOS ​

  1. 打开**XCode**
  2. 导航到 Meteor 项目目录
    ../build-output/ios/project
  3. 打开项目或 .xcworkspace 文件
  4. 在 Xcode 中配置签名
  5. 转到**产品 > 存档**以创建应用程序的存档
  6. 在**组织者**窗口中，点击**分发应用程序**并按照提示配置签名并导出 IPA 文件。
  7. 将 IPA 文件上传到 App Store 或通过 TestFlight 分发。