android 适配工具(ScreenMatch插件)的使用

介绍了一款用于Android开发的屏幕适配插件,通过在Android Studio中集成的菜单选项,简化了不同屏幕尺寸下的资源文件生成过程。该插件支持自定义适配基准和忽略的宽度值,提供默认dimens文件样例,并允许配置是否生成特定尺寸的资源文件。

dp方式屏幕适配原理请看:http://blog.youkuaiyun.com/fesdgasdgasdg/article/details/52325590

                                            http://download.youkuaiyun.com/download/fesdgasdgasdg/9913744

bat批处理文件的使用方式请看:http://blog.youkuaiyun.com/fesdgasdgasdg/article/details/78107653

插件源码请看:https://github.com/mengzhinan/ScreenMatch

 

为了使用方便,我把双击bat的方式改成了在Android Studio中的项目上右键弹出菜单的方式。选择菜单即可完成所有的工作,原理和bat方式一样。

使用步骤如下:

1、下载安装。

点击Browse repositories...去搜索安装,安装好后即可看到ScreenMatch插件,右侧有描述信息和相关连接。

 

2、调起菜单。

安装好后,在项目的任意目录或文件上右击菜单(或按快捷键),即可看到ScreenMatch选项。

 

3、选择在哪个module下执行适配。

即基于哪个module下的res/values/dimens.xml文件作为基准dimens文件,生成的其他尺寸dimens文件放在哪个module下。

 

选择一个,点击确定。

 

 

如果无误,则会有成功提示,如上图。完成了,使用就这么简单。

 

4、提供默认dimens文件样例。

在项目的根目录提供了一个默认的dimens.xml文件样例,怕你不知道怎么写,或者懒。如果不需要,可以删除。在后面讲到的配置文件中可以配置是否生成。

 

5、生成配置文件。

生成了配置文件,如果删除了或者没有创建,则所有的适配都是用默认值,默认值请看源码。

 

6、配置文件详解。



#
# 手机widthDP基准值,一般都是360dp,不建议更改,除非你对屏幕适配原理有深刻的见解。否则不给是或者给360,程序内的默认值为360

base_dp=360

 


# 你还有哪些widthDP值需要适配,多个值以英文逗号分隔。如果算出来的widthDP值有小数,取整。比喻411.948,则取411
# 系统默认适配的widthDP值为: 384,392,400,410,411,480,533,592,600,640,662,720,768,800,811,820,960,961,1024,1280,1365
match_dp=

 


# 如果你觉得系统默认适配的某些值不想要,就在此设置,下次适配时会忽略这些值。多个值以英文逗号分隔。
ignore_dp=

 


# 项目根目录中哪些目录不是module或者你不想让他在Dalog中显示,就在此设置。多个值以英文逗号分隔。
# 系统默认忽略了这些目录:    .gradle,gradle,.idea,build,.git
ignore_module_name=

 


# 请设置默认处理和存放dimes适配文件的module。
# 如果你后面设置了不弹出Dialog,则适配时系统默认取这个module路径处理适配操作。
match_module=app

 


# 是否不弹出适配时的选择对话框,使用上面的match_module默认值。
# 此处赋值为  true 或者 false,默认值为false,即弹出对话框。
not_show_dialog=false

 


# 是否不再生成项目根目录默认的dimens样例文件?怕你不会写,所以我给你生成了
# 此处赋值为   true 或者 false,默认为false,即生成。
not_create_default_dimens=false

 


# 是否同时适配sp字体。因为我怕字体也跟着xxxdp/360dp这样的比例缩放不准确。
# 此处赋值为  true 或者 false,默认值为true,即sp和dp一样,都等比缩放。此处待研究和验证。
is_match_font_sp=true

 

//===以下更新===============================================================

# 关于生成的dimens.xml适配文件夹,你是想用values-wXXXdp 还是 values-swXXXdp 格式?
# 通过对官网文档的查阅,sw意思是smallest width dp的含义,即始终使用最小宽度 dp 值。
# 这样做的好处是,可以解决手机横竖屏切换时到处的意想不到的bug出现,即某些view的宽高尺寸会放大一倍。
# 比喻:你手机的widthDP=360dp,heightDP=640dp。
# 如果竖屏时手机寻找values-w360dp或values下默认的360dp的dimens.xml文件值;
# 如果旋转手机为横屏模式,手机会寻找values-w640dp目录中的dimens.xml文件值;
# 故,导致UI发生变化了。
# sw即表示无论是横屏还是竖屏,手机系统都会使用最小width dp值;
# 即上例中,横竖屏时都使用values-sw360dp或values下默认的360dp的dimens.xml文件值。
# 下面配置项的值如果为false,则表示你只想生成values-wXXXdp格式,如果你的app不涉及到页面横屏。
# 不给值或值为true,表示生成values-swXXXdp格式。
# 默认值为true。
create_values_sw_folder=true


如果你发现你的项目里面的screenMatch.properties配置文件中没有上述某些值,
则请删除你的配置文件,右键项目运行一遍插件,则会再次生成最新的配置。


关于默认的dimens.xml文件内容的问题。这些基础dimen项,难道自己手写?
我早已经给你们提供了模板文件,在你项目的根目录,
与screenMatch.properties配置文件并列的screenMatch_example_dimens.xml文件。
你可以把此screenMatch_example_dimens.xml模板文件更名为dimens.xml复制到....src/main/res/values下,
或者更新已有的....src/main/res/values/dimens.xml文件内容。

 

 

 

 

 

<think>我们正在讨论ScreenMatch插件AndroidStudio中的使用,特别是关于Base_dp和最小宽度的设置规则。根据之前的讨论,我们知道Base_dp始终代表最小宽度(smallestwidth),无论设备方向如何。在Pad设备上,即使横屏时宽度大于高度,最小宽度仍然是高度值(因为最小宽度是屏幕较短的那一边)。现在用户想知道在AndroidStudio中如何使用ScreenMatch插件,以及如何设置Base_dp和最小宽度相关的规则。步骤:1.首先,我们需要解释如何在AndroidStudio中安装和配置ScreenMatch插件。2.然后,详细说明Base_dp的设置以及它如何与最小宽度关联。3.最后,给出一个示例配置,并解释生成的资源文件。注意:ScreenMatch插件通常是通过在项目的res目录下生成多个values-swXXXdp文件夹来实现适配的,每个文件夹中包含根据最小宽度基准计算出的尺寸资源。根据引用[2],我们知道ScreenMatch是由snowdream开发的,但用户提供的引用中并没有直接关于插件使用的详细说明。因此,我们将基于一般的使用方法来解释。下面开始组织回答:</think>### ScreenMatch 插件Android Studio 中的使用指南 #### 一、插件安装与配置 1. **安装步骤**: - 打开 Android Studio → `File` → `Settings` → `Plugins` - 搜索 "ScreenMatch" → 安装后重启 IDE - 验证安装:项目右键菜单出现 `ScreenMatch` 选项[^2] 2. **配置文件创建**: ```properties # 在 module 的 assets 目录创建 ScreenMatch.properties Base_dp = 360 # 设计稿最小宽度基准值 Design_dpi = 160 # 设计稿像素密度(默认160) ``` #### 二、Base_dp 与最小宽度核心规则 ```mermaid graph LR A[设计稿] --> B{Base_dp设置} B --> C[竖屏手机] --> D[最小宽度=屏幕宽度] B --> E[横屏Pad] --> F[最小宽度=屏幕高度] G[实际设备] --> H{计算最小宽度<br>sw = min(宽,高)} H --> I[生成 values-swXXXdp] ``` 1. **Base_dp 本质**: - 始终表示**设计稿的最小宽度基准**(单位:dp) - 设备适配时:`实际最小宽度 = min(设备宽度, 设备高度)` - 示例:设计稿 360dp 宽度 → `Base_dp=360` 2. **Pad 横屏处理**: - 当 Pad 宽度 > 高度时: ```java // 框架内部计算逻辑 float smallestWidth = Math.min(widthPx, heightPx) / density; ``` - 生成的资源目录以高度值命名(如 `values-sw600dp`)[^1] #### 三、操作流程示例 1. **设计稿标注**: - 按 360dp × 640dp 设计界面元素 - 标注按钮宽度:`180dp` → 实际占屏幕 50% 2. **生成适配文件**: - 右键点击 module → `ScreenMatch` → `Generate` - 自动生成目录结构: ``` res/ ├── values-sw360dp/ ├── values-sw400dp/ ├── values-sw600dp/ # Pad 适配目录 └── ... ``` 3. **代码中使用**: ```xml <!-- 布局文件中引用 --> <Button android:layout_width="@dimen/dp_180" android:layout_height="wrap_content"/> ``` 系统自动选择匹配的 `dimens.xml` 文件 #### 四、关键注意事项 1. **设备方向处理**: - 框架通过 `swXXXdp` 自动处理横竖屏切换 - 无需单独编写横屏布局[^1] 2. **Pad 适配建议**: - 设置 `Base_dp ≥ 600`(标准平板值) - 创建独立布局:`layout-sw600dp/main_activity.xml` 3. **验证生成结果**: - 在 `build/generated/screen_match` 查看生成文件 - 使用模拟器切换设备类型验证适配效果 > **最佳实践**:先在 `ScreenMatch.properties` 中设置 `Base_dp` 为设计稿最小宽度,运行生成命令后,在代码中使用 `@dimen/` 引用尺寸[^2]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值