Tangram-iOS 教程：快速入门与关键组件介绍

1. 项目目录结构及介绍

Tangram-iOS 的项目目录包括以下主要部分：

• Docs：存储项目相关的文档。
• Tangram：核心框架的源代码。
• TangramDemo：包含一个简单的iOS应用示例，演示如何在Xcode项目中集成Tangram。
• .gitignore：定义了Git忽略的文件和目录。
• LICENSE：项目采用的MIT许可证。
• Podfile：CocoaPods依赖管理文件。
• README.md：项目简介和指南。

2. 项目的启动文件介绍

在Tangram-iOS中，启动地图展示的核心类是TGMapViewController。这个类继承自UIViewController，并且是集成Tangram地图的关键入口。你可以在你的iOS应用中创建一个TGMapViewController实例，并设置其视图（GLKView）来显示地图。例如，在你的ViewController.swift中，你可以这样初始化：

import UIKit
import Tangram

class ViewController: TGMapViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
    }
    
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
    }
}

这将创建一个基本的地图视图控制器，但为了展示地图，还需要配置场景文件和GLKView。

3. 项目的配置文件介绍

场景文件（Scene File）

场景文件（通常以.yaml扩展名）定义了地图的样式和行为。它包含了关于图层、风格、标签和几何对象的详细信息。例如，你可以指定地图数据来源、图层的颜色和透明度、标记的位置和样式等。要添加场景文件到你的应用，将其放入你的应用资源包中，并在TGMapViewController初始化时加载：

override func viewDidLoad() {
    super.viewDidLoad()

    // 加载场景文件
    let path = Bundle.main.path(forResource: "your_scene_file", ofType: "yaml")
    loadSceneFile(path!)
}

请注意，你需要替换"your_scene_file"为你的实际场景文件名称。

配置GLKView

在故事板（Storyboard）中，你需要添加一个GLKit View作为TGMapViewController的子视图。设置该视图的类为TGMapView，然后在代码中确保连接到你的视图控制器。这允许Tangram在GLKView上进行渲染。

通过以上步骤，你已成功配置了Tangram-iOS的基础架构，并可以开始构建自己的动态地图应用。更多详细信息和高级功能，参考项目文档或在GitHub仓库中查看示例代码。