Pepperoni App Kit 跨平台移动应用开发环境搭建指南

Pepperoni App Kit 跨平台移动应用开发环境搭建指南

pepperoni-app-kit Pepperoni - React Native App Starter Kit for Android and iOS 项目地址: https://gitcode.com/gh_mirrors/pe/pepperoni-app-kit

前言

Pepperoni App Kit 是一个基于 React Native 的跨平台移动应用开发框架，它为开发者提供了一套完整的工具链和最佳实践。本文将详细介绍如何搭建 Pepperoni App Kit 的开发环境，涵盖 iOS 和 Android 两大平台。

系统要求

硬件要求

• Mac 电脑：iOS 开发必须使用 macOS 系统
• Windows/Linux：仅适用于 Android 开发（实验性支持）

软件依赖

在开始之前，请确保你的开发机已安装以下基础软件：

1. Node.js：版本需 ≥5.0.0

   • 推荐使用 yarn 或 npm 3+ 作为包管理工具
   • npm 2.x 版本不被支持

2. Homebrew：macOS 的包管理工具

   • 用于安装和管理其他依赖项

3. React Native CLI：React Native 命令行工具

   npm install -g react-native-cli
   

项目初始化

1. 安装项目依赖

进入项目目录后执行：

npm install

2. 配置环境变量

复制示例配置文件：

cp env.example.js env.js

iOS 开发环境配置

必备工具

1. Xcode：从 Mac App Store 下载安装
   • 包含 iOS 模拟器和必要的构建工具

运行项目

启动 iOS 模拟器并运行应用：

react-native run-ios

专业提示：如需使用 Xcode 进行调试，可直接打开项目中的 .xcodeproj 文件。

Android 开发环境配置

1. 安装 Java 开发工具包

• 下载并安装最新版 JDK

2. 设置 Android SDK

通过 Homebrew 安装：

brew install android-sdk

配置环境变量（添加到 shell 配置文件如 .bashrc 或 .zshrc）：

export ANDROID_HOME=/usr/local/opt/android-sdk

3. 安装必要的 Android 组件

启动 SDK 管理器：

android

需要安装的组件包括：

• Android SDK Tools
• Android SDK Platform-tools
• Android SDK Build-tools（必须使用 23.0.1 版本）
• SDK Platform（API 23）
• Intel x86 系统镜像
• Android 支持库和仓库
• Intel HAXM 硬件加速模块

4. 配置模拟器

1. 安装硬件加速：

open /usr/local/opt/android-sdk/extras/intel/Hardware_Accelerated_Execution_Manager/IntelHAXM_<version>.dmg

2. 创建虚拟设备：

android avd

推荐配置：

• 设备名称：reactnative
• 设备型号：Nexus 5
• 目标平台：Android 6.0（API 23）
• CPU/ABI：Intel Atom x86
• 启用 Host GPU 加速

5. 运行 Android 应用

react-native run-android

高级配置说明

关于 Auth0 集成

Pepperoni App Kit 早期版本集成了 Auth0 身份验证服务，现已作为可选模块提供。开发者可根据项目需求选择是否集成。

Windows 平台支持

目前 Pepperoni App Kit 暂不支持 Windows UWP 平台开发。

常见问题排查

1. Android 构建失败：

   • 确保使用正确的 Build-tools 版本（23.0.1）
   • 检查 ANDROID_HOME 环境变量设置是否正确

2. iOS 模拟器问题：

   • 确保 Xcode 命令行工具已安装
   • 运行 xcode-select --install 安装必要组件

3. 网络连接问题：

   • 在国内网络环境下，建议配置 npm/yarn 镜像源
   • 对于 Android SDK 下载慢的问题，可考虑使用网络优化方案

通过以上步骤，你应该已经成功搭建了 Pepperoni App Kit 的开发环境。这套工具链将帮助你高效地开发跨平台移动应用，享受 React Native 带来的开发便利。

pepperoni-app-kit Pepperoni - React Native App Starter Kit for Android and iOS 项目地址: https://gitcode.com/gh_mirrors/pe/pepperoni-app-kit