Vita3K-Android 项目启动与配置教程

1. 项目目录结构及介绍

Vita3K-Android 是一个开源项目，旨在在 Android 平台上模拟 PlayStation Vita 的游戏。以下是项目的目录结构及其简要介绍：

Vita3K-Android/
├── app/                       # 应用程序主目录，包含 Android 项目的代码
│   ├── src/                   # 源代码目录
│   │   ├── main/              # 主目录，包含主要的 Java/Kotlin 代码
│   │   │   ├── java/          # Java 代码目录
│   │   │   ├── kotlin/        # Kotlin 代码目录
│   │   │   ├── res/           # 资源目录，包含布局、图片、字符串等
│   │   │   │   ├── layout/    # 布局文件目录
│   │   │   │   ├── drawable/  # 图片资源目录
│   │   │   │   ├── mipmap/    # 应用图标目录
│   │   │   │   ├── values/    # 字符串、颜色、尺寸等资源目录
│   │   │   ├── assets/        # 资源文件目录，如字体、配置文件等
│   │   │   └── AndroidManifest.xml # Android 清单文件，定义应用的基本信息和权限
│   ├── build/                 # 构建目录，包含构建输出和中间文件
│   └── app.iml                # IntelliJ IDEA 项目文件
├── Vita3K/                    # Vita3K 源代码目录，包含模拟器的核心代码
├── Vita3K-Emulator/           # 模拟器代码目录
├── .gitignore                 # Git 忽略文件列表
└── README.md                  # 项目说明文件

2. 项目的启动文件介绍

项目的启动文件主要是位于 app/src/main/AndroidManifest.xml。该文件定义了应用的基本信息和所需权限。以下是启动文件的主要内容：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.vita3k.android">

    <!-- 应用权限 -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <!-- 其他组件和配置 -->
    </application>
</manifest>

在这个文件中，<activity> 标签定义了应用的启动活动 MainActivity，而 <intent-filter> 则指定了这个活动为应用的启动入口。

3. 项目的配置文件介绍

项目的配置文件主要位于 app/src/main/res/values/ 目录下，其中包含了字符串资源、颜色定义、尺寸定义等。

strings.xml

位于 res/values/strings.xml 的文件定义了应用中使用的所有字符串资源：

<resources>
    <string name="app_name">Vita3K-Android</string>
    <!-- 其他字符串资源 -->
</resources>

colors.xml

位于 res/values/colors.xml 的文件定义了应用中使用的颜色：

<resources>
    <color name="colorPrimary">#FFBB86FC</color>
    <color name="colorPrimaryVariant">#FF3700B3</color>
    <color name="colorOnPrimary">#FFFFFF</color>
    <!-- 其他颜色定义 -->
</resources>

通过这些配置文件，开发者可以轻松地修改应用的外观和行为，而无需直接修改代码。