Android-Skin-Loader

Introduction: 一个通过动态加载本地皮肤包进行换肤的皮肤框架
More: Author   ReportBugs   
Tags:
换肤-

联系我 : fengjun.dev@gmail.com

个人博客 : http://allenfeng.com/

一个通过动态加载本地皮肤包进行换肤的皮肤框架

广告时间:

本人主讲课程:《Android 应用程序构建实战+原理精讲》

深度掌握 Gradle 使用,系统性学习 Android 应用构建知识。欢迎学习~

更新日志

  • 导入到 Android Studio,使用 gradle 构建皮肤包(见7. 皮肤包是什么?如何生成?)(2015-12-02)
  • 解决 Fragment 换肤在某些版本的 support-v4 包下失效的问题(感谢@javake 同学)(2015-12-02)
  • textColor加入 selector 类型的资源的换肤支持(感谢@pinotao 同学) (2015-09-26)
  • 添加在代码中创建的 View 的换肤支持 (2015-09-24)

工程目录介绍

Android-Skin-Loader
├── android-skin-loader-lib      // 皮肤加载库
├── android-skin-loader-sample   // 皮肤库应用实例
├── android-skin-loader-skin     // 皮肤包生成 demo
└── skin-package                 // 皮肤包输出目录

演示

1. 下载demo, 将BlackFantacy.skin放在 SD 卡根目录

2. 效果图

  • 换肤前 sample

  • 换肤后 sample

用法

1. 在Application中进行初始化

public class SkinApplication extends Application {
    public void onCreate() {
        super.onCreate();
        // Must call init first 
        SkinManager.getInstance().init(this);
        SkinManager.getInstance().load();
    }
}

2. 在布局文件中标识需要换肤的 View

...
xmlns:skin="http://schemas.android.com/android/skin"
...
  <TextView
     ...
     skin:enable="true" 
     ... />

3. 继承BaseActivity或者BaseFragmentActivity作为 BaseActivity 进行开发

4. 从.skin文件中设置皮肤

String SKIN_NAME = "BlackFantacy.skin";
String SKIN_DIR = Environment.getExternalStorageDirectory() + File.separator + SKIN_NAME;
File skin = new File(SKIN_DIR);
SkinManager.getInstance().load(skin.getAbsolutePath(),
                new ILoaderListener() {
                    @Override
                    public void onStart() {
                    }

                    @Override
                    public void onSuccess() {
                    }

                    @Override
                    public void onFailed() {
                    }
                });

5. 重设默认皮肤

SkinManager.getInstance().restoreDefaultTheme();

6. 对代码中创建的 View 的换肤支持

主要由IDynamicNewView接口实现该功能,在BaseActivityBaseFragmentActivityBaseFragment中已经实现该接口.

public interface IDynamicNewView {
    void dynamicAddView(View view, List<DynamicAttr> pDAttrs);
}

用法:动态创建 View 后,调用dynamicAddView方法注册该 View 至皮肤映射表即可(如下).详见 sample 工程

    private void dynamicAddTitleView() {
        TextView textView = new TextView(getActivity());
        textView.setText("Small Article (动态 new 的 View)");
        RelativeLayout.LayoutParams param = new RelativeLayout.LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
        param.addRule(RelativeLayout.CENTER_IN_PARENT);
        textView.setLayoutParams(param);
        textView.setTextColor(getActivity().getResources().getColor(R.color.color_title_bar_text));
        textView.setTextSize(20);
        titleBarLayout.addView(textView);

        List<DynamicAttr> mDynamicAttr = new ArrayList<DynamicAttr>();
        mDynamicAttr.add(new DynamicAttr(AttrFactory.TEXT_COLOR, R.color.color_title_bar_text));
        dynamicAddView(textView, mDynamicAttr);
    }

7. 皮肤包是什么?如何生成?

  • 皮肤包(后缀名为.skin)的本质是一个 apk 文件,该 apk 文件不包含代码,只包含资源文件
  • 在皮肤包工程中(示例工程为skin/BlackFantacy)添加需要换肤的同名的资源文件,直接编译生成 apk 文件,再更改后缀名为.skinj 即可(防止用户点击安装)
  • 使用 gradle 的同学,buildandroid-skin-loader-skin工程后即可在skin-package目录下取皮肤包(修改脚本中def skinName = "BlackFantacy.skin"换成自己想要的皮肤名)

License

Copyright [2015] [FENGJUN]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Apps
About Me
GitHub: Trinea
Facebook: Dev Tools