前言：在安卓上绘制关系图谱网上的解决方案大多是用WebView+js，侵入性较高，对复杂的需求不友好。
Deponder是安卓原生的SDK，接入简单，支持自定义布局和缩放，赋予布局接近物理特性的动态谱图效果。

一、简介和优势

1、简介

Deponder作为在安卓上绘制动态图谱的SDK，使用简单，方便实现自定义需求。

2、Deponder的优点

1.安卓原生，插件形式使用，侵入性低，简单方便。

2.适用于任意布局，任意view集合，而且集合中的view可以是复杂布局，也可以互不相同。

效果图

Deponder GitHub传送门

二、基本使用

0.首先在build.gradle中加入以下代码,引入依赖的SDK.

repositories {
  google()
  mavenCentral()
}

dependencies {
  implementation 'io.github.cinpecan:deponder:0.2.7'
}

假设我们已有布局（也可以是动态布局，例如RecyclerView）

原先采用何种布局或排布并不重要，都会被Deponder变成动态的关系图谱

<FrameLayout  //myGroup

  <TextView  .../>  //myItemA（也可以是复杂布局）
  
  <ImageView  .../> //myItemB（也可以是复杂布局）
  
</FrameLayout>

即

ViewGroup myGroup
TextView  myItemA
ImageView myItemB

1.选择myGroup作为图谱的边界,并创建Deponder

RootOption rootOption = SimpleRootOption.builder()
            .itemView(myGroup)
            .build());
DeponderControl<PlanetOption, RubberOption> deponder = new Deponder<>(this, rootOption);//this可为activity,fragment或其它实现生命周期回收者

2.设置你期望myItemA,myItemB拥有的物理属性

PlanetOption myItemAOption = SimplePlanet.builder()
            .itemView(myItemA)
            //设定一个唯一标识(默认String.valueOf([YOUR CHILD VIEW].hashCode())
            .id(String.valueOf(myItemA.hashCode()))
            .build();

PlanetOption myItemBOption = SimplePlanet.builder()
            .itemView(myItemB)
            .id(String.valueOf(myItemB.hashCode()))
            .build();

//放入集合
List<PlanetOption> listPlanet = new ArrayList<>();
listPlanet.add(myItemAOption );
listPlanet.add(myItemBOption );

3.提交包含物理属性的视图集合到Deponder中，让图谱动起来

（1）提交myItemA,myItemB的集合到Deponder中

deponder.submitPlanet(listPlanet);
deponder.submitRubber(new ArrayList());//这是橡皮筋集合，如果不需要，提交个空集合即可，需要的话往下看

动起来了! 现在，myItemA、myItemB 在 myGroup 的范围中，因为物理特性而自然的分散开来。

如果你想要拖拽来操控它们，你可以自定义拖拽手势监听，也可以使用Deponder提供的简单手势监听。

DeponderHelper.bindDefTouchPlanet(myItemA);
DeponderHelper.bindDefTouchPlanet(myItemB);

4.如果你希望有一根强力的橡皮筋，两端绑上myItemA、myItemB，并可以像橡皮筋一样横向拉伸或压缩，用以强调对象的关系

i：准备一个宽高不为0的View加入myGroup中，作为橡皮筋

例如我们的布局中加入一个View：

<LinearLayout //myGroup
  
  <TextView  .../>  //myItemA
  
  <ImageView  .../>  //myItemB
  
  <View  .../>  //myRubberA（宽高不为0）（也可以是复杂布局）
  
</LinearLayout>

即

View myRubberA

ii：设置你期望myRubberA拥有的物理属性

RubberOption rubberA=SimpleRubber.builder()
                //两端绑定的item的id
                .sId(myItemAOption.id())
                .eId(myItemBOption .id())
                //放入准备好的橡皮筋视图
                .itemView(myRubberA)
                //可以设定想要的弹性系数
                .elasticityCoefficient(1.68f)
                //设定橡皮筋的自然长度
                .naturalLength(300)
                .build();

//放入集合
List<RubberOption > listRubber=new ArrayList<>();
listRubber.add(rubberA);

iii：提交橡皮筋集合到Deponder中

deponder.submitRubber(listRubber);

橡皮筋生效了，它会将两个关系的对象拉扯在一起，并保持一定距离

5.放大和缩小

当元素过多过少，或者为了布局美观，可能想要Deponder能缩放它们，这非常简单，例如所有已接管对象放大到1.5倍

deponder.submitScale(1.5);

三、更进一步

1.如果你希望橡皮筋视图 不被伸缩 可以加入tag，告诉Deponder这个视图不需要伸缩

<View   //myRubberA
  ...
  android:tag="UN_RUBBER_RUBBER"
  ...
.../> 

如果橡皮筋是复杂视图，还可以给局部添加该tag，仅局部不被伸缩

2.如果你希望对象间斥力变成引力，可以将弹性系数设为负数试试

3.还有更多接口，比如空气阻尼，质量，弹性系数可供开发者使用
i：比如希望图谱稳定得更快，可以试试减少质量，加大弹性系数，
ii：比如希望模仿重力，可以试试仅设置下边框的引力，或设置上边框的斥力，并设置铺满布局的影响范围。

更详细的内容：Deponder GitHub传送门
满地打滚求求Star

本文最后更新于2022.6