# 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-22

## 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.2'
}
```

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

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

### 转换示例

| 设计图标注（1200px宽度） | Dimen引用 | 实际值（sw360dp） |
|------------------------|-----------|-------------------|
| 10px | `@dimen/dl_dp_10` | 3.00dp |
| 20px | `@dimen/dl_dp_20` | 6.00dp |
| 100px | `@dimen/dl_dp_100` | 30.00dp |
| 200px | `@dimen/dl_dp_200` | 60.00dp |
| -10px | `@dimen/dl_dp_m_10` | -3.00dp |
| 28px（字体） | `@dimen/dl_sp_28` | 8.40sp |

### 在布局文件中使用

```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)
适配后尺寸 = 设计图标注值 × (360/1200) × 缩放比例 = 设计图标注值 × 0.3 × 缩放比例
```

## Dimen 命名规则

### 核心规律

```
设计图缩放到 1200px 宽度
设计图标注 xxx 像素 → 使用 @dimen/dl_dp_xxx
实际值 = xxx × 0.3 dp（两位小数精度）
格式：<dimen name="dl_dp_(m_)xxx">yyydp</dimen>
```

### dp 尺寸示例

```xml
<!-- 负值（_m_ 表示 negative/minus） -->
<dimen name="dl_dp_m_10">-3.00dp</dimen>     <!-- xxx=10, yyy=-3.00 -->
<dimen name="dl_dp_m_5">-1.50dp</dimen>      <!-- xxx=5, yyy=-1.50 -->
<dimen name="dl_dp_m_2">-0.60dp</dimen>      <!-- xxx=2, yyy=-0.60 -->
<dimen name="dl_dp_m_1">-0.30dp</dimen>      <!-- xxx=1, yyy=-0.30 -->

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

<!-- 正值 -->
<dimen name="dl_dp_1">0.30dp</dimen>         <!-- xxx=1, yyy=0.30 -->
<dimen name="dl_dp_2">0.60dp</dimen>         <!-- xxx=2, yyy=0.60 -->
<dimen name="dl_dp_5">1.50dp</dimen>         <!-- xxx=5, yyy=1.50 -->
<dimen name="dl_dp_10">3.00dp</dimen>        <!-- xxx=10, yyy=3.00 -->
```

### sp 尺寸示例

```xml
<dimen name="dl_sp_1">0.30sp</dimen>         <!-- xxx=1, yyy=0.30 -->
<dimen name="dl_sp_2">0.60sp</dimen>         <!-- xxx=2, yyy=0.60 -->
<dimen name="dl_sp_5">1.50sp</dimen>         <!-- xxx=5, yyy=1.50 -->
<dimen name="dl_sp_10">3.00sp</dimen>        <!-- xxx=10, yyy=3.00 -->
```

## 已生成的分辨率

从 sw320dp 到 sw1200dp，每隔 10dp 一份，共 **89 个分辨率**：

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

## 尺寸范围

- **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-sw330dp/dimens.xml
├── values-sw360dp/dimens.xml
├── values-sw480dp/dimens.xml
├── values-sw720dp/dimens.xml
└── ... (共 89 个分辨率)
```