Skip to content

Latest commit

 

History

History
244 lines (188 loc) · 11.1 KB

README.md

File metadata and controls

244 lines (188 loc) · 11.1 KB
Raw

DependencyLayout

概述

Download

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

引入依赖

Gradle方式--适合Android Studio用户

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

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

方式二：使用jetpack仓库，在根项目的build.gradle中添加下面的代码

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

然后在需要使用的模块的build.gradle中添加以下代码

dependencies {
    implementation 'com.github.Brook007:DependencyLayout:1.1.4'
}

使用

在实例化DependencyLayout之前加入以下代码

DependencyLayoutConfig.getInstance()
    // 设计图中的宽度
    .setDesignWidth("750px")
    // 设计图中高度
    .setDesignHeight("1294px");

也可以在XML布局文件中配置

app:designHeight="1294px"
app:designWidth="750px"

当两个同时配置时，默认优先选择Xml中的配置，Demo中有一个简单的登录页面的实现，可以给大家一些参考activity_simple.xml

效果预览

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

标准720P分辨率和1080P分辨率的对比

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

分辨率差距极大的480P分辨率和2K分辨率对比的对比

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

设计图与实际效果对比

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

真机预览

示例下载

Demo.apk

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接口

默认提供了一个TextView字体大小适配的实现类TextViewImpl

实现了接口后，需要添加到注册到DependencyLayoutConfig类中，使用一下代码注册适配类

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的字体绘制可见下图

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

更新预告

  • 添加TextView字体的支持
  • 代码优化与其他BUG修复

联系作者

Email:brook999999@qq.com

QQ群交流：651080648 Android交流反馈群

关于屏幕适配的前辈方案

  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

Copyright (c) 2016-present, Brook007 Contributors.

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.