Google Project Tango C API 示例项目教程

1. 项目的目录结构及介绍

Google的Project Tango是针对移动设备开发的，旨在通过增强现实技术提供深度感知能力的平台。尽管该项目已被废弃，但其提供的示例代码对于学习深度感应和运动追踪技术依然有很高的参考价值。在仓库 googlearchive/tango-examples-c 中，您可以找到一系列使用C语言编写的示例应用程序。

以下是该仓库的基本目录结构及其简介：

.
├── android_manifest.xml          # 安卓应用清单文件
├── CMakeLists.txt                # CMake构建脚本
├── jni                            # 包含JNI接口和C源码
│   ├── Android.mk                 # Android NDK Makefile
│   ├── Application.mk             # 应用程序NDK配置
│   └── src                        # C源代码
├── java                           # Java绑定代码用于与原生代码交互
│   └── com                       # 包含安卓相关的Java类
└── README.md                      # 项目说明文档

每个示例都有自己的子目录，例如 cpp_augmented_reality_example、cpp_marker_detection_example 等，它们各自包含了实现特定功能的源代码文件，以及必要的资源和配置文件，展示如何利用Tango SDK进行特定场景的应用开发。

2. 项目的启动文件介绍

在每个示例应用程序中，并没有一个单一明确标记为“启动文件”的文件，但是入口点通常位于C语言源码中的main()函数。以JNI为例，实际的启动流程始于Android应用的Activity（位于Java目录下），然后通过JNI桥接调用到C/C++层的代码。比如，在JNI目录下的源码中，您将找到类似这样的结构，其中JNI_OnLoad函数是库加载时被调用的关键点，而真正应用逻辑的起点往往是在某个特定的函数中，这取决于应用的具体目的。

// 假设的一个示例
#include <jni.h>
#include "your_c_function_entry.h"

JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *reserved) {
    // 初始化操作
    return JNI_VERSION_1_6;
}

// 实际业务逻辑可能从这里开始，例如：
void startExample() {
    // 示例代码逻辑...
}

3. 项目的配置文件介绍

3.1 AndroidManifest.xml

这是Android应用的核心配置文件，定义了应用的权限需求、活动(ACTIVITIES)、服务(SERVICES)等。在Tango示例项目中，它包含了Tango所需的所有权限声明，如相机访问和传感器读取权限。

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera.ar" android:required="true" />
<!-- 其他必要的权限声明 -->

3.2 CMakeLists.txt

对于CMake构建系统来说，这是指导如何构建项目的主要文件。它定义了项目的源文件、依赖项和目标输出。在Tango示例项目中，这个文件指定了在哪里查找源代码、如何编译这些代码以及最终生成的动态库或可执行文件。

3.3 Android.mk 和 Application.mk

这两个文件属于Android Native Development Kit (NDK) 的构建系统部分，尤其是在使用旧版构建方式时。Android.mk 定义了原生模块的编译规则，而Application.mk 提供更高级别的编译选项，例如目标平台版本和启用的特性。

综上所述，虽然具体的配置文件细节可能因示例不同而有所变化，理解以上基本结构和文件作用对熟悉并运行这些项目至关重要。请注意，由于项目已不再维护，可能需解决依赖更新或兼容性问题才能成功运行在现代的开发环境和设备上。