|
|
@@ -0,0 +1,156 @@
|
|
|
+# Android-Skin-Loader
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+> 联系我 : [email protected]
|
|
|
+>
|
|
|
+> 个人博客 : [http://allenfeng.com/](http://allenfeng.com/)
|
|
|
+>
|
|
|
+> 一个通过动态加载本地皮肤包进行换肤的皮肤框架
|
|
|
+
|
|
|
+
|
|
|
+## 广告时间：
|
|
|
+
|
|
|
+本人主讲课程：[《Android 应用程序构建实战+原理精讲》](https://coding.imooc.com/class/465.html)
|
|
|
+
|
|
|
+深度掌握 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](https://github.com/fengjundev/Android-Skin-Loader/tree/master/skin-package), 将`BlackFantacy.skin`放在SD卡根目录
|
|
|
+#### 2. 效果图
|
|
|
+- 换肤前
|
|
|
+
|
|
|
+
|
|
|
+- 换肤后
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+## 用法
|
|
|
+
|
|
|
+#### 1. 在`Application`中进行初始化
|
|
|
+```java
|
|
|
+public class SkinApplication extends Application {
|
|
|
+ public void onCreate() {
|
|
|
+ super.onCreate();
|
|
|
+ // Must call init first
|
|
|
+ SkinManager.getInstance().init(this);
|
|
|
+ SkinManager.getInstance().load();
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+#### 2. 在布局文件中标识需要换肤的View
|
|
|
+
|
|
|
+```xml
|
|
|
+...
|
|
|
+xmlns:skin="http://schemas.android.com/android/skin"
|
|
|
+...
|
|
|
+ <TextView
|
|
|
+ ...
|
|
|
+ skin:enable="true"
|
|
|
+ ... />
|
|
|
+```
|
|
|
+
|
|
|
+#### 3. 继承`BaseActivity`或者`BaseFragmentActivity`作为BaseActivity进行开发
|
|
|
+
|
|
|
+
|
|
|
+#### 4. 从`.skin`文件中设置皮肤
|
|
|
+```java
|
|
|
+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. 重设默认皮肤
|
|
|
+```java
|
|
|
+SkinManager.getInstance().restoreDefaultTheme();
|
|
|
+```
|
|
|
+
|
|
|
+#### 6. 对代码中创建的View的换肤支持
|
|
|
+主要由`IDynamicNewView`接口实现该功能，在`BaseActivity`，`BaseFragmentActivity`和`BaseFragment`中已经实现该接口.
|
|
|
+
|
|
|
+```java
|
|
|
+public interface IDynamicNewView {
|
|
|
+ void dynamicAddView(View view, List<DynamicAttr> pDAttrs);
|
|
|
+}
|
|
|
+```
|
|
|
+**用法：**动态创建View后，调用`dynamicAddView`方法注册该View至皮肤映射表即可(如下).详见sample工程
|
|
|
+
|
|
|
+```java
|
|
|
+ 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文件，再更改后缀名为`.skin`j即可（防止用户点击安装）
|
|
|
+- 使用gradle的同学，build`android-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.
|
|
|
+
|
