DependencyLayout

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #android #rust #deep-learning #docker #macos #windows #cli #pytorch #mcp #openai #open-source

DependencyLayout

(★ 8)

一个相对布局容器，多种相对位置属性支持，继承自ViewGroup，支持屏幕适配(以宽或者高其中之一为基准的百分比计算)

DependencyLayout Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DependencyLayout

## 概述
[ ![Download](https://api.bintray.com/packages/brook007/maven/DependencyLayout/images/download.svg?version=1.1.4) ](https://bintray.com/brook007/maven/DependencyLayout/1.1.2/link)
[![](https://jitpack.io/v/Brook007/DependencyLayout.svg)](https://github.com/Brook007/DependencyLayout)
[![](https://img.shields.io/badge/Platform-Android-brightgreen.svg)](https://github.com/Brook007/DependencyLayout)
[![](https://img.shields.io/badge/API_Live-14+-brightgreen.svg)](https://github.com/Brook007/DependencyLayout)
[![](https://img.shields.io/badge/License-Apache_2-brightgreen.svg)](https://github.com/Brook007/DependencyLayout/blob/master/LICENSE)
[![](https://img.shields.io/badge/%E4%BD%9C%E8%80%85-Brook007-orange.svg)](https://github.com/Brook007)

一个相对布局容器，继承自ViewGroup，并支持百分比布局缩放，下面是关于Library的简单介绍，对于代码中的问题，欢迎大家反馈问题并提Issue，喜欢的朋友可以Star一下，您的Star是对开源作者最好的支持

## 引入依赖
### Gradle方式--适合Android Studio用户

#### 方式一：使用jcenter仓库，在build.gradle中添加（推荐）

```groovy
implementation 'com.brook.android:DependencyLayout:1.1.4'
```

#### 方式二：使用jetpack仓库，在根项目的build.gradle中添加下面的代码
```groovy
allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}
```
然后在需要使用的模块的build.gradle中添加以下代码
```groovy
dependencies {
    implementation 'com.github.Brook007:DependencyLayout:1.1.4'
}
```

## 使用

在实例化DependencyLayout之前加入以下代码
```java
DependencyLayoutConfig.getInstance()
    // 设计图中的宽度
    .setDesignWidth("750px")
    // 设计图中高度
    .setDesignHeight("1294px");
```
也可以在XML布局文件中配置
```xml
app:designHeight="1294px"
app:designWidth="750px"
```

当两个同时配置时，默认优先选择Xml中的配置，Demo中有一个简单的登录页面的实现，可以给大家一些参考[activity_simple.xml](https://github.com/Brook007/DependencyLayout/blob/master/app/src/main/res/layout/activity_simple.xml)

## 效果预览
### 下面是在几个分辨率屏幕适配的对比图(注意：示例图中的标题栏并未加入适配)

<b/>标准720P分辨率和1080P分辨率的对比

[![](https://raw.githubusercontent.com/Brook007/DependencyLayout/master/picture/720_1280_AND_1080_1920.png)](https://github.com/Brook007/DependencyLayout)

<b/>标准2K分辨率和目前最常见的全面屏分辨率(1080x2340)的对比

[![](https://raw.githubusercontent.com/Brook007/DependencyLayout/master/picture/1440_2560_AND_1080_2340.png)](https://github.com/Brook007/DependencyLayout)

<b/>分辨率差距极大的480P分辨率和2K分辨率对比的对比

[![](https://raw.githubusercontent.com/Brook007/DependencyLayout/master/picture/480_800_AND_1440_2560.png)](https://github.com/Brook007/DependencyLayout)

<b/>以及你现在找都找不到的QVGA分辨率和WVGA分辨率对比（也许有些手表是这个级别的分辨率吧）

[![](https://raw.githubusercontent.com/Brook007/DependencyLayout/master/picture/240_320_AND_480_800.png)](https://github.com/Brook007/DependencyLayout)

### 设计图与实际效果对比

[![](https://raw.githubusercontent.com/Brook007/DependencyLayout/master/picture/comparison.png)](https://github.com/Brook007/DependencyLayout)

这里附带了27款真机的运行效果图

### 示例下载

## DependencyLayout支持的属性
|属性|类型|描述|
|---|---|---|
| designWidth | string | 设计图中的宽度 |
| designHeight | string | 设计图中的高度 |
| dependency_padding | string | DependencyLayout支持的的内边距 |
| dependency_paddingLeft | string | DependencyLayout支持的的左边距 |
| dependency_paddingTop | string | DependencyLayout支持的的上边距 |
| dependency_paddingRight | string | DependencyLayout支持的的右边距 |
| dependency_paddingBottom | string | DependencyLayout支持的的下边距 |
| android:padding | dimension | 系统的属性的内边距 |
| android:paddingLeft | dimension | 系统的属性的左边距 |
| android:paddingTop | dimension | 系统的属性的上边距 |
| android:paddingRight | dimension | 系统的属性的右边距 |
| android:paddingBottom | dimension | 系统的属性的下边距 |

## DependencyLayout子View支持的属性
|属性|类型|描述|
|---|---|---|
| alignParentLeft | boolean | View上边对齐到父View的左边  |
| alignParentTop | boolean | View上边对齐到父View的上边 |
| alignParentRight | boolean | View上边对齐到父View的右边 |
| alignParentBottom | boolean | View上边对齐到父View的下边 |
| toParentCenterVerticalLeft | boolean | View右边对齐到父View垂直中线的左边 |
| toParentCenterVerticalRight | boolean | View左边对齐到父View垂直中线的右边 |
| alignParentCenterHorizontalTop | boolean | View下边对齐到父View水平中线的上边 |
| alignParentCenterHorizontalBottom | boolean | View上边对齐到父View水平中线的下边 |
| centerInParentHorizontal | boolean | View在DependencyLayout中水平居中 |
| centerInParentVertical | boolean | View在DependencyLayout中垂直居中 |
| centerInParent | boolean | View在DependencyLayout中水平和垂直居中 |
| aboveTo | reference | View在引用的View上边 |
| toRightOf | reference | View在引用的View右边 |
| belowTo | reference | View在引用的View下边 |
| toLeftOf | reference | View在引用的View左边 |
| alignTop | reference | View上边与引用的View上边对齐 |
| alignRight | reference | View右边与引用的View右边对齐 |
| alignBottom | reference | View下边与引用的View下边对齐 |
| alignLeft | reference | View左边与引用的View左边对齐  |
| toCenterVerticalLeft | reference | View位于引用的View水平中线左边 |
| toCenterVerticalRight | reference | View位于引用的View水平中线右边 |
| alignCenterHorizontalTop | reference | View位于引用的View垂直中线上边 |
| alignCenterHorizontalBottom | reference | View位于引用的View垂直中线下边 |
| centerVerticalOf | reference | View的水平中线与引用的View的水平中线对齐 |
| centerHorizontalOf | reference | View的垂直中线与引用的View的垂直中线对齐 |
| centerOf | reference | View在引用的View的中间 |
| dependency_marginLeft | string | View左边距与偏移 |
| dependency_marginTop | string | View上边距与偏移 |
| dependency_marginRight | string | View右边距与偏移 |
| dependency_marginBottom | string | View下边距与偏移 |
| dependency_padding | string | View的内边距 |
| dependency_paddingLeft | string | View的左边距 |
| dependency_paddingTop | string | View的上边距 |
| dependency_paddingRight | string | View的右边距 |
| dependency_paddingBottom | string | View的下边距 |
| selfWidth | string | 自身的宽度 |
| selfHeight | string | 自身的高度 |
| android:layout_width | dimension | 使用系统设置的宽度 |
| android:layout_height | dimension | 使用系统设置的高度 |
| android:layout_marginLeft | dimension | 使用系统设置的左边距 |
| android:layout_marginRight | dimension | 使用系统设置的右边距 |
| android:layout_marginTop | dimension | 使用系统设置的上边距 |
| android:layout_marginBottom | dimension | 使用系统设置的下边距 |
| android:padding | dimension | 使用系统设置的内边距 |
| android:paddingLeft | dimension | 使用系统设置的内左边距 |
| android:paddingTop | dimension | 使用系统设置的内上边距 |
| android:paddingRight | dimension | 使用系统设置的内右边距 |
| android:paddingBottom | dimension | 使用系统设置的内下边距 |

## 特性

对于使用，基本类似于RelativeLayout，但是比RelativeLayout多一些功能，不然的话也没必要写这个了
对于DependencyLayout上面的属性中，除了designWidth，和designHeight外，其他的类型是string的属性都支持以下几种写法

```
字母的含义
// 倒数第二位首字母
p->parent 父View
s->screen 屏幕
m->myself 自身
// 倒数第一位首字母
w->width  宽度
h->height 高度
```
|格式|介绍|
|---|---|
|xx%pw | 父View宽度的xx% |
| xx%ph| 父View高度的xx% |
| xx%sw| 屏幕宽度的xx% |
| xx%sh| 屏幕高度的xx% |
| xx%mw| 自身宽度的xx% |
| xx%mh| 自身高度的xx% |
| xxdp|
| xxpx|
| xx  | 与设计图单位自动匹配 |

### 第三方View属性的适配

有时我们可能需要对一些第三方的View的属性进行适配我们需要实现[ViewAdapter.java](https://github.com/Brook007/DependencyLayout/blob/master/library/src/main/java/com/brook/app/android/supportlibrary/adapter/ViewAdapter.java)接口

默认提供了一个TextView字体大小适配的实现类[TextViewImpl](https://github.com/Brook007/DependencyLayout/blob/master/library/src/main/java/com/brook/app/android/supportlibrary/adapter/TextViewImpl.java)

实现了接口后，需要添加到注册到DependencyLayoutConfig类中，使用一下代码注册适配类
```java
DependencyLayoutConfig.getInstance(this)
    /*Other Initial*/
    .addViewAdapterHandler(TextView.class, new TextViewImpl());
```

### 注意事项

* 当设置DependencyLayout中的高度为wrap_content的时候，那么子View中不能设置xx%ph属性，否则会出错，同理，当设置DependencyLayout中的宽度为wrap_content的时候，那么子View中不能设置xx%pw属性

* 由于计算精度与类型转换为，计算出的实际大小可能会有1个像素的差别

* 属性间存在优先级问题，如当设置了dependency_paddingBottom时，android:paddingBottom属性就会失效，同理，当设置selfWidth的时候android:layout_width属性就会失效

* **关于演示图中的偏差，由于TextView字体问题，TextView的字体绘制可见下图**

[![](https://raw.githubusercontent.com/Brook007/DependencyLayout/master/picture/android_text_measure.png)](https://github.com/Brook007/DependencyLayout)

实际的情况可以看上面的效果预览图中最后一图中的最右边的开启了布局边界的部分，可以验证这个说法

## 更新预告
 - ~~添加TextView字体的支持~~
 - 代码优化与其他BUG修复

## 联系作者

Email:brook999999@qq.com

QQ群交流：651080648 <a target="_blank" href="http://shang.qq.com/wpa/qunwpa?idkey=f91d47f1f3b88cb1cf2915f3ac4fc8c9e2fa77f964c8f81128ca77b095387b52"><img border="0" src="http://pub.idqqimg.com/wpa/images/group.png" alt="Android交流反馈群" title="Android交流反馈群"></a>

## 关于屏幕适配的前辈方案

1. AutoLayout <https://github.com/hongyangAndroid/AndroidAutoLayout>
2. ScaleLayout <https://github.com/gavinliu/Android-ScaleLayout>
3. percent-support-lib <https://github.com/JulienGenoud/android-percent-support-lib-sample>
4. AutoSize <https://github.com/JessYanCoding/AndroidAutoSize>

## 开源协议  LICENSE

Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.

DependencyLayout

DependencyLayout Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

DependencyLayout

DependencyLayout Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README