NASA WorldWind Android 项目使用教程

NASA WorldWind Android 项目使用教程

WorldWindAndroid The NASA WorldWind Java SDK for Android (WWA) includes the library, examples and tutorials for building 3D virtual globe applications for phones and tablets. 项目地址: https://gitcode.com/gh_mirrors/wo/WorldWindAndroid

1. 项目目录结构及介绍

NASA WorldWind Android 项目的目录结构如下：

WorldWindAndroid/
├── gradle/
│   └── wrapper/
├── worldwind-examples/
├── worldwind-tutorials/
├── worldwind/
├── .gitignore
├── .travis.yml
├── CONTRIBUTING.md
├── ISSUE_TEMPLATE.md
├── LICENSE.txt
├── PULL_REQUEST_TEMPLATE.md
├── README.md
├── WorldWindAndroid.iml
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
└── settings.gradle

目录结构介绍

• gradle/: 包含 Gradle Wrapper 的相关文件，用于确保项目使用一致的 Gradle 版本。
• worldwind-examples/: 包含示例代码，展示了如何使用 WorldWind Android SDK 构建 3D 虚拟地球应用程序。
• worldwind-tutorials/: 包含教程代码，帮助开发者逐步学习如何使用 WorldWind Android SDK。
• worldwind/: 核心库文件，包含了 WorldWind Android SDK 的主要功能实现。
• .gitignore: Git 忽略文件，指定了哪些文件和目录不需要被版本控制。
• .travis.yml: Travis CI 配置文件，用于持续集成和自动化测试。
• CONTRIBUTING.md: 贡献指南，指导开发者如何为项目贡献代码。
• ISSUE_TEMPLATE.md: 问题模板，帮助用户提交问题时提供必要的信息。
• LICENSE.txt: 项目许可证文件，遵循 NASA 开源协议。
• PULL_REQUEST_TEMPLATE.md: 拉取请求模板，帮助开发者提交代码变更。
• README.md: 项目说明文件，包含了项目的概述、安装和使用说明。
• WorldWindAndroid.iml: IntelliJ IDEA 项目文件。
• build.gradle: 项目的 Gradle 构建脚本，定义了项目的依赖和构建配置。
• gradle.properties: Gradle 属性文件，包含了一些全局配置。
• gradlew: Gradle Wrapper 的 Unix 脚本。
• gradlew.bat: Gradle Wrapper 的 Windows 脚本。
• settings.gradle: Gradle 设置文件，定义了项目的模块和依赖关系。

2. 项目启动文件介绍

项目的启动文件主要是 build.gradle 和 settings.gradle。

build.gradle

build.gradle 是项目的构建脚本，定义了项目的依赖、插件和其他构建配置。以下是该文件的主要内容：

// 应用 Android 插件
apply plugin: 'com.android.application'

// 定义项目依赖
dependencies {
    compile 'gov.nasa.worldwind.android:worldwind:0.8.0'
}

// 其他构建配置
android {
    // Android 构建配置
}

settings.gradle

settings.gradle 是 Gradle 的设置文件，定义了项目的模块和依赖关系。以下是该文件的主要内容：

// 包含项目模块
include ':worldwind', ':worldwind-examples', ':worldwind-tutorials'

3. 项目配置文件介绍

项目的配置文件主要包括 gradle.properties 和 local.properties。

gradle.properties

gradle.properties 文件包含了 Gradle 构建过程中使用的全局属性。以下是该文件的主要内容：

# 定义 Gradle 构建属性
org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8

local.properties

local.properties 文件包含了项目的本地配置，通常用于指定 Android SDK 的路径。以下是该文件的主要内容：

# 指定 Android SDK 路径
sdk.dir=/path/to/android/sdk

通过以上配置文件，开发者可以自定义项目的构建和运行环境，确保项目在不同开发环境中的一致性。

WorldWindAndroid The NASA WorldWind Java SDK for Android (WWA) includes the library, examples and tutorials for building 3D virtual globe applications for phones and tablets. 项目地址: https://gitcode.com/gh_mirrors/wo/WorldWindAndroid