如何快速上手AndroidScreenAdaptation：从0到1的完整接入教程（依赖+初始化+配置全解析）

如何快速上手AndroidScreenAdaptation从0到1的完整接入教程依赖初始化配置全解析【免费下载链接】AndroidScreenAdaptationA light and easy-to-use Android development screen adaptation tool library(一个轻量好用的安卓开发屏幕适配工具库)项目地址: https://gitcode.com/gh_mirrors/an/AndroidScreenAdaptationAndroidScreenAdaptation是一个轻量好用的安卓开发屏幕适配工具库它让你完全不用改变原有的布局编写习惯不用继承适配类、不用包裹适配布局、不用新建一堆分辨率适配文件夹还支持代码动态添加 View 的适配、实时预览布局、旋转与分屏适配。本教程带你用 4 个步骤完成完整接入10 分钟即可在项目中跑起来。为什么推荐 AndroidScreenAdaptation很多新手一接触多分辨率适配就头疼同一份布局在不同手机上错位、文字大小不一、还要维护layout-xhdpi、layout-xxhdpi等大量文件夹。AndroidScreenAdaptation 的核心卖点是✅零侵入布局怎么写的就继续怎么写无需继承特殊基类✅单位自由px、dp 均可但全局要统一不强制使用某种单位✅动态适配代码动态addView的场景也能适配✅所见即所得布局预览是什么样真机跑出来就是什么样✅覆盖全面旋转屏幕、7.0 分屏、全面屏/虚拟按键手机都没问题其原理很简单以设计图的宽度px和标准 dpi为基准按「手机实际宽度 / 设计图宽度」的比例等比缩放所有控件从而在不同分辨率、不同屏幕密度、不同最小宽度的设备上都保持一致效果。一键安装步骤添加依赖只需 1 行在你的模块build.gradle文件的dependencies中追加一行即可implementation me.yatoooon:screenadaptation:1.1.1如果你想直接引入本仓库中的库模块方便看源码也可以换成implementation project(:screenadaptation)参考示例工程中的写法app/build.gradle该工程最低支持minSdkVersion 15老项目也能放心接入。初始化配置全解析Application meta-data 两步走这是接入的核心分为两步。第 1 步创建自定义 Application 并调用 init新建一个继承Application的类示例工程中的 App.java在onCreate()中调用初始化public class App extends Application { Override public void onCreate() { super.onCreate(); // 读取清单文件中的 meta-data 完成初始化 ScreenAdapterTools.init(this); } // 旋转适配如果应用固定了某个屏幕方向不旋转如 QQ、微信下面这段可不写 Override public void onConfigurationChanged(Configuration newConfig) { super.onConfigurationChanged(newConfig); ScreenAdapterTools.getInstance().reset(this); } } 工具类ScreenAdapterTools.init()会自动从清单文件读取 4 个配置项源码见screenadaptation/src/main/java/com/yatoooon/screenadaptation/ScreenAdapterTools.java你不需要手动传参。第 2 步AndroidManifest.xml 中声明 4 个 meta-data在application标签中声明你的 Application并添加 4 个meta-data配置application android:name.App ... meta-data android:namedesignwidth android:value1080 / !-- 设计图的宽px推荐用 Markman 测量 -- meta-data android:namedesigndpi android:value480 / !-- 设计图对应的标准 dpi -- meta-data android:namefontsize android:value1.0 / !-- 全局字体倍数老板嫌字大/字小改这一处即可 -- meta-data android:nameunit android:valuepx / !-- 布局里用的单位px 或 dp全局统一不要用 sp -- /application两个高频疑问设计图是 750px 宽怎么办那多半是 iOS 的设计图尽量找 UI 要一份 Android 的如果只有其他宽度选一个相近的 dpi 即可。designdpi 怎么填按下面这张对应表查设计图宽24032048072010801440DPI 等级LDPIMDPIHDPIXHDPIXXHDPIXXXHDPIDPI 数值12016024032048064030 秒开始使用在合适的位置加一行 loadView配置完成后只需在「拿到布局 View 之后」加一行适配调用。场景一普通 ActivityOverride protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main_dp); // 在 setContentView() 后面加上适配语句 ScreenAdapterTools.getInstance().loadView(getWindow().getDecorView()); }如果希望 Android 7.0 分屏也能适配可在onConfigurationChanged中再补一句reset(this)。场景二Fragment / RecyclerView / ListView只要你能找到「布局填充器」拿到 View 后调用loadView(view)即可例如 FragmentView view inflater.inflate(R.layout.test_px, container, false); ScreenAdapterTools.getInstance().loadView(view); return view;场景三自定义 View 与纯代码绘制自定义 View 中请包一层判断否则在 Android Studio 中预览 XML 会报错不影响真机if (!isInEditMode()) { ScreenAdapterTools.getInstance().loadView(view); }如果控件属性完全是代码绘制的比如手动画了个半径 100dp 的圆用loadCustomAttrValue单独适配该数值circleRadius ScreenAdapterTools.getInstance().loadCustomAttrValue(circleRadius);进阶适配属性范围怎么扩展默认情况下loadView走的是SimpleConversion适配宽、高、padding、margin、字体大小这几个最常用的属性源码screenadaptation/src/main/java/com/yatoooon/screenadaptation/conversion/SimpleConversion.java。如果你还用了minWidth、maxWidth这类属性换成CustomConversion即可ScreenAdapterTools.getInstance().loadView(view, new CustomConversion());有更特殊的属性需求自行继承IConversion和AbsLoadViewHelper编写扩展即可扩展入口清晰、成本很低。常见问题排查Q预览和真机效果不一致检查两点①unit配置必须和布局文件里的单位统一都 px 或都 dp② 预览顶部的小手机图标要选一个与设计图匹配的模拟器再按设计图测量编写布局。Q字体为什么不让用 spsp 会跟随系统字体大小变化而主流 App微信、QQ的字体并不跟随系统变化所以本库要求字体也用 px 或 dp。Q接入后需要改布局吗不需要。这正是本库最大的优点——你原先怎么写的布局就继续怎么写按设计图测量、直接写单位真机效果与预览一致。总结4 步完成 Android 屏幕适配步骤操作耗时1️⃣ 加依赖build.gradle加一行implementation1 分钟2️⃣ 初始化自定义 Application 中调ScreenAdapterTools.init(this)3 分钟3️⃣ 配置清单文件声明 4 个meta-data3 分钟4️⃣ 使用各页面拿到 View 后调loadView(view)按需轻量、零侵入、配置少——对于被多分辨率适配折磨的 Android 开发者来说AndroidScreenAdaptation 是一个可以快速落地、立刻见效的选择。现在就去你的项目里试试10 分钟后告别错位布局吧【免费下载链接】AndroidScreenAdaptationA light and easy-to-use Android development screen adaptation tool library(一个轻量好用的安卓开发屏幕适配工具库)项目地址: https://gitcode.com/gh_mirrors/an/AndroidScreenAdaptation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考