Bevy 移动端开发指南

Bevy 确实支持 iOS 和 Android 平台开发，但需要特定的配置和工具链。本指南将详细介绍如何在移动平台上开发 Bevy 游戏。

支持状态

✅ iOS: 完全支持
✅ Android: 完全支持
⚠️ 注意：需要额外配置和工具链

环境准备

Android 开发环境

必需工具:

# 安装 Android SDK
rustup target add aarch64-linux-android armv7-linux-androideabi# 安装 Android NDK
# 推荐使用 Android Studio 安装，或直接下载 NDK# 安装 Cargo-apk
cargo install cargo-apk

环境变量配置:

export ANDROID_SDK_ROOT=/path/to/android-sdk
export NDK_HOME=/path/to/android-ndk

iOS 开发环境

必需工具:

# 安装 iOS 目标
rustup target add aarch64-apple-ios x86_64-apple-ios# 安装 Xcode 命令行工具
xcode-select --install# 安装 cargo-xcode
cargo install cargo-xcode

项目配置

Cargo.toml 配置

[package]
name = "my_bevy_game"
version = "0.1.0"
edition = "2021"[dependencies]
bevy = "0.11.0"[lib]
name = "my_bevy_game"
crate-type = ["staticlib", "cdylib"][package.metadata.android]
build_targets = ["aarch64-linux-android", "armv7-linux-androideabi"]
min_sdk_version = 16
target_sdk_version = 31[package.metadata.ios]
bundle_id = "com.example.mybevygame"

Android 配置

my_bevy_game/
├── android/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── AndroidManifest.xml
│   │   │       ├── res/
│   │   │       └── java/
│   │   └── build.gradle
│   └── build.gradle
└── src/

AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="com.example.mybevygame"><applicationandroid:allowBackup="true"android:icon="@mipmap/ic_launcher"android:label="@string/app_name"android:theme="@style/Theme.AppCompat.NoActionBar"><activityandroid:name="android.app.NativeActivity"android:configChanges="orientation|keyboardHidden|screenSize"android:exported="true"><meta-dataandroid:name="android.app.lib_name"android:value="my_bevy_game" /><intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /></intent-filter></activity></application>
</manifest>

iOS 配置

创建 iOS 项目结构:

my_bevy_game/
├── ios/
│   ├── src/
│   │   └── lib.rs
│   ├── Info.plist
│   └── Assets.xcassets/
└── src/

Info.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict><key>CFBundleDevelopmentRegion</key><string>en</string><key>CFBundleExecutable</key><string>my_bevy_game</string><key>CFBundleIdentifier</key><string>com.example.mybevygame</string><key>CFBundleInfoDictionaryVersion</key><string>6.0</string><key>CFBundleName</key><string>My Bevy Game</string><key>CFBundlePackageType</key><string>APPL</string><key>CFBundleShortVersionString</key><string>1.0</string><key>CFBundleVersion</key><string>1</string><key>LSRequiresIPhoneOS</key><true/><key>UILaunchStoryboardName</key><string>Launch Screen</string><key>UIRequiredDeviceCapabilities</key><array><string>arm64</string></array><key>UISupportedInterfaceOrientations</key><array><string>UIInterfaceOrientationPortrait</string><string>UIInterfaceOrientationLandscapeLeft</string><string>UIInterfaceOrientationLandscapeRight</string></array>
</dict>
</plist>

构建和运行

Android 构建

# 构建 APK
cargo apk build --release# 安装到设备
cargo apk run --release

iOS 构建

# 生成 Xcode 项目
cargo xcode# 使用 Xcode 打开项目并运行
open ios/my_bevy_game.xcodeproj

移动端特定优化

1. 性能优化

rust">use bevy::prelude::*;fn main() {App::new().insert_resource(Msaa::Off) // 关闭 MSAA 以提高性能.add_plugins(DefaultPlugins.set(WindowPlugin {primary_window: Some(Window {resolution: (1280., 720.).into(),..default()}),..default()})).run();
}

2. 触摸输入处理

rust">fn touch_system(touches: Res<Touches>) {for touch in touches.iter() {println!("触摸位置: {:?}", touch.position());if touch.just_pressed() {println!("开始触摸");}if touch.just_released() {println!("结束触摸");}}
}

3. 屏幕适配

rust">fn setup(mut commands: Commands) {// 自适应相机commands.spawn(Camera2dBundle {projection: OrthographicProjection {scale: 1.0,..default()},..default()});
}