《HelloMap3D》开源项目启动与配置教程

1. 项目目录结构及介绍

HelloMap3D 项目的主要目录结构如下：

hellomap3d/
├── android/
│   ├── app/
│   │   ├── src/
│   │   │   ├── main/
│   │   │   │   ├── java/
│   │   │   │   ├── res/
│   │   │   │   └── AndroidManifest.xml
│   │   │   └── build.gradle
│   │   └── build.gradle
│   └── gradle/
│       └── wrapper/
│           └── gradle-wrapper.properties
├── ios/
│   ├── HelloMap3D.xcodeproj/
│   └── HelloMap3D/
│       ├── Assets.xcassets/
│       ├── Info.plist
│       └── Main.storyboard
├── samples/
│   ├── java/
│   └── objective-c/
├── settings.gradle
└── gradle/
    └── wrapper/
        └── gradle-wrapper.properties

• android/: Android 平台的代码目录。
  • app/: Android 应用的主体目录，包含 Java 源代码、资源文件以及 AndroidManifest.xml。
• ios/: iOS 平台的代码目录。
  • HelloMap3D.xcodeproj/: Xcode 项目文件。
  • HelloMap3D/: 包含项目资源文件和主界面故事板。
• samples/: 示例代码目录，包含 Java 和 Objective-C 的示例代码。
• settings.gradle: Gradle 设置文件，用于配置项目。
• gradle-wrapper.properties: Gradle 包装器配置文件。

2. 项目的启动文件介绍

Android 启动文件

在 Android 平台中，启动文件通常是 android/app/src/main/AndroidManifest.xml。

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

    <application
        ...
        android:label="@string/app_name">
        <activity
            android:name=".MainActivity"
            android:label="@string/app_name"
            android:theme="@style/AppTheme.NoActionBar">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        ...
    </application>

</manifest>

这个文件定义了应用的启动 Activity，以及一些应用级别的配置。

iOS 启动文件

在 iOS 平台中，启动文件通常是 HelloMap3D/Info.plist。

这个文件包含了应用的基本信息和配置，如应用名称、图标、支持的设备方向等。

3. 项目的配置文件介绍

Android 配置文件

在 Android 项目中，主要的配置文件是 android/app/build.gradle。

plugins {
    id 'com.android.application'
}

android {
    compileSdkVersion 29
    defaultConfig {
        applicationId "com.example.hellomap3d"
        minSdkVersion 21
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"
    }
    ...
}

dependencies {
    implementation project(':hellomap3d')
    // 其他依赖
}

这个文件定义了项目的编译设置、应用 ID、最低和目标 SDK 版本、版本号等。

iOS 配置文件

在 iOS 项目中，主要的配置文件是 HelloMap3D.xcodeproj/ 中的项目设置，包括 Build Settings 和 Info.plist。

Build Settings 中可以配置编译器选项、架构、SDK 版本等。Info.plist 文件中包含了应用的各种元数据和配置，如应用名称、版本、支持的设备类型等。