README

!Logo
!Official


   
    
  
  
    
  
  
    
  
  
    
  
  
    
  
  
    
  



 今日头条屏幕适配方案终极版，一个极低成本的 Android 屏幕适配方案.


 Overview
 Pixel 2 XL | 1440 x 2880 | 560dpi:

   
   
   


 Pixel XL | 1440 x 2560 | 560dpi:

   
   
   


 Nexus 5X | 1080 x 1920 | 420dpi:

   
   
   


 Nexus 4 | 768 x 1280 | 320dpi:

   
   
   


 Nexus S | 480 x 800 | 240dpi:

   
   
   


 Notice
 主流机型设备信息，可以作为参考

 功能介绍

 原理分析

 今日头条屏幕适配方案常见问题汇总

 Android 进阶框架

 对于老项目，如果使用了 AndroidAutoLayout，请参考 AndroidAutoLayout 迁移指南，AndroidAutoSize 可以和 AndroidAutoLayout 一起使用，因为 AndroidAutoLayout 使用的是 px，所以 AndroidAutoSize 对它不会产生任何影响，如果老项目的某些页面之前使用了 dp 进行布局，并且 AndroidAutoSize 对这些页面已经产生了不良影响，可以让之前使用了 dp 的旧 Activity 实现 CancelAdapt 取消适配，建议使用副单位，使用副单位则不会影响之前使用了 dp 的页面 (也不会影响三方库和系统控件)，详情请查看 demo-subunits 

 Download
 Jcenter ( ⚠️ 已停止维护: 2022 年 2 月 1 日之后 JCenter 远程仓库将无法使用):
 gradle
 implementation 'me.jessyan:autosize:1.2.1'


 JitPack:
Step 1. Add the JitPack repository in your root build.gradle at the end of repositories:

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


Step 2. Add the dependency

gradle
dependencies {
    implementation 'com.github.JessYanCoding:AndroidAutoSize:v1.2.1'
}


 Usage
 Step 1 (真的不吹牛逼，只需要以下这一步，框架就可以对项目中的所有页面进行适配)
 请在 AndroidManifest 中填写全局设计图尺寸 (单位 dp)，如果使用副单位，则可以直接填写像素尺寸，不需要再将像素转化为 dp，详情请查看 demo-subunits
xml

                
        
                   
                




 Preview
 布局时的实时预览在开发阶段是一个很重要的环节，很多情况下 Android Studio 提供的默认预览设备并不能完全展示我们的设计图，所以我们就需要自己创建模拟设备，下面就介绍下 dp、pt、in、mm 这四种单位的模拟设备创建方法

 如果您在预览时不希望在 Preview 中出现状态栏和导航栏, 则可以根据下图选择 panel 主题，使用该主题后纵向分辨率刚好填充整个预览页面，显示效果完全和设计图一致
!theme

 为了方便广大新手，所以还是将创建模拟设备的步骤贴出来，为大家操碎了心，如果觉得 AndroidAutoSize 不错，请一定记得 star，并将 AndroidAutoSize 推荐给您的伙伴们
!create step

 DP
 如果您在 layout 文件中使用 dp 作为单位进行布局 (AndroidAutoSize 默认支持 dp、sp 进行布局)，则可以根据公式 (sqrt(纵向分辨率^2+横向分辨率^2))/dpi 求出屏幕尺寸，然后创建模拟设备 (只用填写屏幕尺寸和分辨率)
!dp

 PT
 如果您在 layout 文件中使用 pt 作为单位进行布局 (需要通过 AutoSizeConfig.getInstance().getUnitsManager().setSupportSubunits(Subunits.PT); 打开对单位 pt 的支持)，则可以根据公式 (sqrt(纵向分辨率^2+横向分辨率^2))/72 求出屏幕尺寸，然后创建模拟设备 (只用填写屏幕尺寸和分辨率)
!pt

 IN
 如果您在 layout 文件中使用 in 作为单位进行布局 (需要通过 AutoSizeConfig.getInstance().getUnitsManager().setSupportSubunits(Subunits.IN); 打开对单位 in 的支持)，则可以根据公式 sqrt(纵向分辨率^2+横向分辨率^2) 求出屏幕尺寸，然后创建模拟设备 (只用填写屏幕尺寸和分辨率)
!in

 MM
 如果您在 layout 文件中使用 mm 作为单位进行布局 (需要通过 AutoSizeConfig.getInstance().getUnitsManager().setSupportSubunits(Subunits.MM); 打开对单位 mm 的支持)，则可以根据公式 (sqrt(纵向分辨率^2+横向分辨率^2))/25.4 求出屏幕尺寸，然后创建模拟设备 (只用填写屏幕尺寸和分辨率)
!mm

 Advanced (以下用法看不懂？答应我，认真看 demo 好不好？)

 Activity
 当某个 Activity 的设计图尺寸与在 AndroidManifest 中填写的全局设计图尺寸不同时，可以实现 CustomAdapt 接口扩展适配参数
java
public class CustomAdaptActivity extends AppCompatActivity implements CustomAdapt {

    @Override
    public boolean isBaseOnWidth() {
        return false;
    }

    @Override
    public float getSizeInDp() {
        return 667;
    }
}


 当某个 Activity 想放弃适配，请实现 CancelAdapt 接口
java
public class CancelAdaptActivity ex