# AndroidScreenMatch

**Repository Path**: yemesoft/android-screen-match

## Basic Information

- **Project Name**: AndroidScreenMatch
- **Description**: 零负担适配常用设备屏幕
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Android Screen Match 屏幕适配方案

本项目采用基于 **Smallest Width (sw)** 的 Android 屏幕适配方案，通过自动生成多套 dimens 资源文件，实现不同分辨率设备的自适应布局。

## 快速开始

### 依赖引用

在项目根目录的 `build.gradle` 中添加仓库：

```groovy
repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
}
```

在 app 模块的 `build.gradle` 中添加依赖：

```groovy
dependencies {
    implementation 'com.gitee.yemesoft:android-screen-match:1.1'
}
```

## 设计图尺寸与 Dimen 对应关系

**一句话总结：** 将设计图缩放到 **720px 宽度**，获得的尺寸 xxx，对应的 dp/sp 值就是 `@dimen/dl_(dp|sp)(_m)_xxx`。

### 转换示例

| 设计图标注（720px宽度） | Dimen引用 | 实际值（sw360dp） |
|------------------------|-----------|-------------------|
| 4px | `@dimen/dl_dp_4` | 2dp |
| 3px | `@dimen/dl_dp_3` | 1.5dp |
| 2px | `@dimen/dl_dp_2` | 1dp |
| 1px | `@dimen/dl_dp_1` | 0.5dp |
| -2px | `@dimen/dl_dp_m_2` | -1dp |
| 28px（字体） | `@dimen/dl_sp_28` | 14sp |

### 在布局文件中使用

```xml
<Button
    android:layout_width="@dimen/dl_dp_200"    <!-- 设计图 200px -->
    android:layout_height="@dimen/dl_dp_96"     <!-- 设计图 96px -->
    android:padding="@dimen/dl_dp_32"          <!-- 设计图 32px -->
    android:textSize="@dimen/dl_sp_28"          <!-- 设计图字体 28px -->
    android:text="确认" />
```

### 在代码中使用

```kotlin
val dpValue = resources.getDimension(R.dimen.dl_dp_200)
val spValue = resources.getDimension(R.dimen.dl_sp_28)
```

## 适配原理

### 基准分辨率

以 **sw360dp** 作为基准分辨率。

### 缩放公式

```
缩放比例(scale) = 目标分辨率(targetDp) / 基准分辨率(360dp)
适配后尺寸 = 基准尺寸 × 缩放比例
```

## Dimen 命名规则

### 核心规律

```
yyy 从 -1960 到 1960，步长 0.5
xxx = 2 * yyy
格式：<dimen name="dl_dp_(m_)xxx">yyydp</dimen>
```

### dp 尺寸示例

```xml
<!-- 负值（_m_ 表示 negative/minus） -->
<dimen name="dl_dp_m_4">-2dp</dimen>      <!-- xxx=4, yyy=-2 -->
<dimen name="dl_dp_m_3">-1.5dp</dimen>    <!-- xxx=3, yyy=-1.5 -->
<dimen name="dl_dp_m_2">-1dp</dimen>       <!-- xxx=2, yyy=-1 -->
<dimen name="dl_dp_m_1">-0.5dp</dimen>     <!-- xxx=1, yyy=-0.5 -->

<!-- 零值 -->
<dimen name="dl_dp_0">0dp</dimen>

<!-- 正值 -->
<dimen name="dl_dp_1">0.5dp</dimen>        <!-- xxx=1, yyy=0.5 -->
<dimen name="dl_dp_2">1dp</dimen>          <!-- xxx=2, yyy=1 -->
<dimen name="dl_dp_3">1.5dp</dimen>        <!-- xxx=3, yyy=1.5 -->
<dimen name="dl_dp_4">2dp</dimen>          <!-- xxx=4, yyy=2 -->
```

### sp 尺寸示例

```xml
<dimen name="dl_sp_1">0.5sp</dimen>        <!-- xxx=1, yyy=0.5 -->
<dimen name="dl_sp_2">1sp</dimen>          <!-- xxx=2, yyy=1 -->
<dimen name="dl_sp_3">1.5sp</dimen>        <!-- xxx=3, yyy=1.5 -->
<dimen name="dl_sp_4">2sp</dimen>          <!-- xxx=4, yyy=2 -->
```

## 已生成的分辨率

从 sw320dp 到 sw1960dp，每隔 20dp 一份，共 **83 个分辨率**：

**主要覆盖区间：**
- 手机：sw320dp 到 sw600dp
- 平板：sw600dp 到 sw1960dp

## 尺寸范围

- **dp 尺寸**：-1960dp 到 1960dp（步长 0.5dp，xxx: 1~3920）
- **sp 尺寸**：0.5sp 到 200sp（步长 0.5sp，xxx: 1~400）

## 资源文件结构

```
screenmatch/src/main/res/
├── values-sw320dp/dimens.xml
├── values-sw360dp/dimens.xml
├── values-sw480dp/dimens.xml
├── values-sw720dp/dimens.xml
└── ... (共 83 个分辨率)
```