Tangram-Android 开源项目教程

项目介绍

Tangram 是一个模块化的 UI 解决方案，用于动态构建原生页面，包括 Tangram for Android、Tangram for iOS 以及后台 CMS。本项目提供了 Android 平台的 SDK，基于 vlayout 和 UltraViewPager。

特点

• 双平台支持：支持 Android 和 iOS。
• 动态构建页面：通过 JSON 创建页面视图，并提供了默认的解析器。
• 高性能：基于 vlayout，支持扩展功能模块。
• 多种默认布局：支持通过 JSON 数据或代码自定义布局样式。

项目快速启动

环境准备

确保你的开发环境满足以下要求：

• Android Studio 3.0 或更高版本。
• Gradle 4.1 或更高版本。

添加依赖

在你的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.alibaba.android:tangram:3.3.6'
    implementation 'com.alibaba.android:vlayout:1.2.36'
    implementation 'com.alibaba.android:ultraviewpager:1.0.7.8'
}

初始化

在你的 Application 类中初始化 Tangram：

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化 Tangram
        TangramBuilder.init(this);
    }
}

创建布局

创建一个布局文件 activity_main.xml：

<com.alibaba.android.vlayout.VirtualLayoutManager
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/virtualLayoutManager"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.alibaba.android.vlayout.layout.LinearLayoutHelper
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>
</com.alibaba.android.vlayout.VirtualLayoutManager>

加载数据

在你的 Activity 中加载数据并绑定到布局：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        RecyclerView recyclerView = findViewById(R.id.recyclerView);
        VirtualLayoutManager layoutManager = new VirtualLayoutManager(this);
        recyclerView.setLayoutManager(layoutManager);

        // 加载数据并绑定到布局
        // 示例代码：加载 JSON 数据
        String jsonData = "..."; // 你的 JSON 数据
        Card card = TangramBuilder.parseCard(jsonData);
        recyclerView.setAdapter(new TangramAdapter(card));
    }
}

应用案例和最佳实践

应用案例

Tangram 已被广泛应用于电商、新闻、社交等多个领域。例如，阿里巴巴的多个移动应用中都使用了 Tangram 来动态构建页面。

最佳实践

• 模块化设计：将页面拆分为多个模块，每个模块负责不同的功能，便于管理和维护。
• 动态更新：通过后台 CMS 动态更新页面内容，无需重新发布应用。
• 性能优化：合理使用缓存和预加载机制，提升页面加载速度。

典型生态项目

vlayout

vlayout 是一个强大的布局管理器，支持多种布局方式，如线性布局、网格布局、瀑布流布局等。

UltraViewPager

UltraViewPager 是一个扩展的 ViewPager，支持无限循环、自动滚动、多页面展示等功能。

Virtualview

Virtualview 是一个基于 XML 的视图系统，支持动态加载和更新视图。

通过这些生态项目，Tangram 提供了完整的解决方案，帮助开发者快速构建高性能的动态页面。