AndroidAutoSize 使用教程

AndroidAutoSize 使用教程

AndroidAutoSize🔥 A low-cost Android screen adaptation solution (今日头条屏幕适配方案终极版，一个极低成本的 Android 屏幕适配方案).项目地址:https://gitcode.com/gh_mirrors/an/AndroidAutoSize

1. 项目介绍

AndroidAutoSize 是一个轻量级的Android屏幕适配解决方案，基于今日头条的屏幕适配方案封装而成，提供了自动化和自定义扩展的屏幕适配功能。它简化了在不同分辨率设备上保持布局一致性的复杂过程，同时允许开发者灵活地调整适配策略。

2. 项目快速启动

2.1 添加依赖

首先，在你的 build.gradle 文件（app module）中添加依赖：

dependencies {
    implementation 'me.jessyan:autosize:1.1.2'
}

同步Gradle后，就可以开始使用AndroidAutoSize了。

2.2 初始化配置

在应用程序的 onCreate() 方法中初始化AndroidAutoSize，通常你会在 MyApplication 类里面做这件事：

@Override
protected void attachBaseContext(Context base) {
    super.attachBaseContext(base);
    AutoSizeConfig.getInstance().setContext(base)
            .setUseDeviceDefault(false)
            .init();
}

@Override
public void onCreate() {
    super.onCreate();
    AutoSizeConfig config = AutoSizeConfig.getInstance();
    int designWidthInDp = 360; // 设计稿的标准宽度
    int designHeightInDp = 640; // 设计稿的标准高度
    config.setDesignWidthInDp(designWidthInDp).setDesignHeightInDp(designHeightInDp).apply();
}

这里设置了设计稿的标准宽高，以便进行适配。

2.3 应用适配

现在，你可以让你的Activity自动进行适配。只需确保在 setContentView() 之前调用了 super.onCreate():

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState); // 保证在这行之上
    // ...
    setContentView(R.layout.activity_main);
}

3. 应用案例和最佳实践

3.1 自定义适配策略

如果你需要自定义适配策略，可以创建一个实现 CustomAdapt 接口的类：

public class MyCustomAdapt implements CustomAdapt {
    @Override
    public boolean isBaseOnWidth() {
        return true; // 或者false，取决于你希望基于宽度还是高度适配
    }

    @Override
    public float getSizeInDp() {
        return 360f; // 相应的方向上的设计稿 dp 值
    }
}

然后在初始化配置时使用该策略：

AutoSizeConfig.getInstance().setCustomAdapt(new MyCustomAdapt()).apply();

3.2 纵向适配

对于纵向适配，需要自定义Activity并实现 CustomAdapt：

public class VerticalAdaptActivity extends AppCompatActivity implements CustomAdapt {
    ...

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        AutoSizeConfig.getInstance().setCustomAdapt(this).apply();
        setContentView(R.layout.activity_vertical_adapt);
    }

    // 实现 CustomAdapt 接口方法
    @Override
    public boolean isBaseOnWidth() {
        return false;
    }

    @Override
    public float getSizeInDp() {
        return 640f;
    }
}

4. 典型生态项目

由于AndroidAutoSize的设计理念和良好的兼容性，已被广泛应用于各种开源项目，例如：

• Material Design Components
• SmartRefreshLayout
• Retrofit

这些项目在不同程度上利用了AndroidAutoSize来进行屏幕适配和提高用户体验。

---

以上就是AndroidAutoSize的基本使用及一些实践建议，更多详细信息和进阶用法，可以查阅项目的官方文档或源码。祝你在使用过程中一切顺利！

AndroidAutoSize🔥 A low-cost Android screen adaptation solution (今日头条屏幕适配方案终极版，一个极低成本的 Android 屏幕适配方案).项目地址:https://gitcode.com/gh_mirrors/an/AndroidAutoSize