安卓开发 drawable资源文件命名

Posted 2023-04-26

参考技术A drawable

全部小写，采用下划线命名法，加前缀区分

命名规则：

通用：用途_逻辑名

通用：用途_颜色

模块专用：用途_模块名_逻辑名

模块专用：用途_模块名_颜色

说明：用途也指控件类型（具体见附录1：控件缩写表）

可加后缀 _small 表示小图， _big 表示大图，逻辑名称可由多个单词加下划线组成.

举例：

名称 说明

btn_main_home.png 按键用途_模块名_逻辑名称

divider_maket_white.png 分割线用途_模块名_颜色

ic_edit.png 图标用途_逻辑名称

bg_main.png 背景用途_逻辑名称

btn_red.png 红色按键用途_颜色

btn_red_big.png 红色大按键用途_颜色

ic_head_small.png 小头像用途_逻辑名称

bg_input.png 输入框背景用途_逻辑名称

divider_white.png 白色分割线用途_颜色

bg_main_head 主模块头部背景图片用途_模块名_逻辑名称

def_search_cell 默认搜索界面单元图片用途_模块名_逻辑名称

ic_more_help 更多帮助图标用途_逻辑名称

divider_list_line 列表分割线用途_逻辑名称

sel_search_ok 搜索界面确认选择器用途_模块名_逻辑名称

shape_music_ring 音乐界面环形形状用途_模块名_逻辑名称

如果有多种形态，如按钮选择器：sel_btn_xx.xml

sel_btn_xx 按钮图片使用btn_整体效果（selector）

btn_xx_normal 按钮图片使用btn_正常情况效果

btn_xx_pressed 按钮图片使用btn_点击时候效果

btn_xx_focused state_focused聚焦效果

btn_xx_disabled state_enabled (false)不可用效果

btn_xx_checked state_checked选中效果

btn_xx_selected state_selected选中效果

btn_xx_hovered state_hovered悬停效果

btn_xx_checkable state_checkable可选效果

btn_xx_activated state_activated激活的

btn_xx_windowfocused state_window_focused

Android中的Drawable资源

https://blog.csdn.net/yuzhiyuxia/article/details/8806488

 

在Android应用中，常常会用到Drawable资源，比如图片资源等，在Android开发中我们是用Drawable类来Drawable类型资源的。

Drawable资源一般存储在应用程序目录的\\res\\drawable目录下,当然依据分辨率的高低可以分别存储不同分辨率的资源到如下几个目录：

\\res\\drawable-hdpi

\\res\\drawable-ldpi

\\res\\drawable-mdpi

\\res\\drawable-xdpi

其SDK文档中声明如下：

我们看到Drawable是一个抽象类（abstract class），它有好多子类（SubClass）来操作具体类型的资源，比如BitmapDrawable是用来操作位图，ColorDrawable用来操作颜色，

ClipDrawable用来操作剪切板等。

图片资源

图片资源是简单的Drawable资源，目前Android支持的图片格式有：gif、png、jpg等。我们只需要把图片资源放置到\\res\\drawable目中，那么在编译后的R.java类中就会生成图片资源的资源ID

我们在程序中就可以通过调用相关的方法来获取图片资源（程序中如果要访问drawable_resource_file_name，那么可以如此：[packagename].R.drawable.drawable_resource_file_name）。

注：Android中drawable中的资源名称有约束，必须是： [a-z0-9_.]（即：只能是字母数字及_和.），而且不能以数字开头，否则编译会报错： Invalid file name: must contain only [a-z0-9_.]

以下代码片段演示了如何访问一个图片资源(资源名称drawablefilename):

1.  
   ImageView imageView=(ImageView)findViewById(com.jeriffe.app.R.id.ImageView1);
2.  
   imageView.setImageResource(com.jeriffe.app.R.drawable.drawablefilename);

StateListDrawable资源

StateListDrawable内可以分配一组Drawable资源，StateListDrawable 被定义在一个XML文件中，以 <selector> 元素起始。其内部的每一个Drawable资源内嵌在<item>元素中。

当StatListDrawable资源作为组件的背景或者前景Drawable资源时，可以随着组件状态的变更而自动切换相对应的资源，例如，一个Button可以处于不同的状态(按钮按下、获取焦点)

我们可以使用一个StateListDrawable资源，来提供不同的背景图片对于每一个状态。，当组件的状态变更时，会自定向下遍历StateListDrawable对应的xml文件来查找第一个匹配的Item。

StatListDrawable资源所支持的组件状态如下图所示：

以下代码片段是一个StateListDrawable资源的XML文件描述样例：

XML 文件存储在： res/drawable/button_statelist.xml:

1.  
   <?xml version="1.0" encoding="utf-8"?>
2.  
   <selector xmlns:android="http://schemas.android.com/apk/res/android">
3.  
   <item android:state_pressed="true"
4.  
   android:drawable="@drawable/button_pressed" /> <!-- pressed -->
5.  
   <item android:state_focused="true"
6.  
   android:drawable="@drawable/button_focused" /> <!-- focused -->
7.  
   <item android:state_hovered="true"
8.  
   android:drawable="@drawable/button_focused" /> <!-- hovered -->
9.  
   <item android:drawable="@drawable/button_normal" /> <!-- default -->
10.  
    </selector>

以下是Button的Layout文件：

1.  
   <Button
2.  
   android:layout_height="wrap_content"
3.  
   android:layout_width="wrap_content"
4.  
   android:background="@drawable/button" />

当然我们也可以通过代码来设置Button的背景图片：

1.  
   Button imageButton=(Button)findViewById(R.id.imageButton);
2.  
    
3.  
   imageButton.setBackgroundResource(com.jeriffe.app.R.drawable.button_statelist);

ShapeDrawable资源

ShapeDrawable资源绘制一个特定的形状，比如矩形、椭圆等。如果你想自己动态的绘制二位图形，那么我们就可以使用ShapeDrawable资源对象，用ShapeDrawable,我们可以绘制我们所能想象的形状。。一个ShapeDrawable 需要一个Shape对象来管理呈现资源到UI Screen,如果没有Shape设置，那么会默认使用RectShape对象。

ShapeDrawable 被定义在一个XML文件中，以 <shape> 元素起始。其内部的每一个Drawable资源内嵌在<item>元素中

以下代码片段便是一个ShapeDrawable的XML定义

1.  
   <?xml version="1.0" encoding="UTF-8"?>
2.  
   <shape xmlns:android="http://schemas.android.com/apk/res/android"
3.  
   android:shape="oval">
4.  
   <!-- 定义填充渐变颜色 -->
5.  
   <gradient
6.  
   android:startColor="#00f"
7.  
   android:endColor="#00f"
8.  
   android:angle="45"
9.  
   android:type="sweep"/>
10.  
    <!-- 设置内填充 -->
11.  
    <padding android:left="7dp"
12.  
    android:top="7dp"
13.  
    android:right="7dp"
14.  
    android:bottom="7dp" />
15.  
    <!-- 设置圆角矩形 -->
16.  
    <corners android:radius="8dp" />
17.  
    </shape>

我们可以用ShapeDrawable 来设置组件的背景色（用setBackgroundDrawable()方法），如上的代码片段可设置一个TextEdit的背景色为蓝色的椭圆形状。当然我们也可以绘制自定义的View

我们构建自定义形状的View时，由于ShapeDrawable 有其自己的draw()方法，我们可以构建一个View视图的子类，然后override View.onDraw()方法，如下代码片段是一个样例：

1.  
   public class CustomDrawableView extends View {
2.  
   private ShapeDrawable mDrawable;
3.  
    
4.  
   public CustomDrawableView(Context context) {
5.  
   super(context);
6.  
    
7.  
   int x = 10;
8.  
   int y = 10;
9.  
   int width = 300;
10.  
    int height = 50;
11.  
     
12.  
    mDrawable = new ShapeDrawable(new OvalShape());
13.  
    mDrawable.getPaint().setColor(0xff74AC23);
14.  
    mDrawable.setBounds(x, y, x + width, y + height);
15.  
    }
16.  
     
17.  
    protected void onDraw(Canvas canvas) {
18.  
    mDrawable.draw(canvas);
19.  
    }
20.  
    }

基于上述代码我们可以在我们的Activity中编程的构建自定义视图：

1.  
   CustomDrawableView mCustomDrawableView;
2.  
    
3.  
   protected void onCreate(Bundle savedInstanceState) {
4.  
   super.onCreate(savedInstanceState);
5.  
   mCustomDrawableView = new CustomDrawableView(this);
6.  
    
7.  
   setContentView(mCustomDrawableView);
8.  
   }

当然我们也可以使用XML文件来描述：自定义的Drawable类必须重载view (Context, AttributeSet) 构造函数。接着我们添加Layout文件如下：

 

1.  
   <com.example.shapedrawable.CustomDrawableView
2.  
   android:layout_width="fill_parent"
3.  
   android:layout_height="wrap_content"
4.  
   />

ClipDrawable

ClipDrawable资源定义在一个XML中，表示裁剪(Clips)一个其他资源基于ClipDrawable资源的Level。你可以控制裁剪的Drawable的宽度高度及gravity属性，ClipDrawable常常被用来作为一个progressbars的实现。

以下样例是一个ClipDrawable资源：

1.  
   <?xml version="1.0" encoding="utf-8"?>
2.  
    
3.  
   <clip xmlns:android="http://schemas.android.com/apk/res/android"
4.  
    
5.  
   android:drawable="@drawable/android"
6.  
    
7.  
   android:clipOrientation="horizontal"
8.  
    
9.  
   android:gravity="left" />

下面的ImageView布局文件应用Clipdrawable资源：

 

1.  
   <ImageView
2.  
    
3.  
   android:id="@+id/image"
4.  
    
5.  
   android:background="@drawable/clip"
6.  
    
7.  
   android:layout_height="wrap_content"
8.  
    
9.  
   android:layout_width="wrap_content" />
10.  
     

下面的代码获取drawable并且增加其裁剪，以便于渐增的显示图像

1.  
   ImageView imageview = (ImageView) findViewById(R.id.image);
2.  
    
3.  
   ClipDrawable drawable = (ClipDrawable) imageview.getDrawable();
4.  
    
5.  
   drawable.setLevel(drawable.getLevel() + 1000);

当然我们可以使用一个Timer来实现图片的渐增显示。

注意: 默认的Level值是0，表示图片被这个裁剪，故图片是不可见的。当值达到10000是代码裁剪为0，图片可以完全显示。

AnimationDrawable

AnimationDrawable

AnimationDrawable通过定义一系列的Drawable对象构建一个基于帧的动画(frame-by-frame animations)，可以被用来作为视图的背景色。

最简单的构建一个帧动画是在XML文件中构建一个动画,我们可以设定动画作为视图的背景色，通过调用AnimationDrawable.start()方法来运行动画。

如下代码片段是一个AnimationDrawable资源的XML文件,资源文件位置：res\\drawable\\spin_animation.xml

1.  
   <animation-list xmlns:android="http://schemas.android.com/apk/res/android"
2.  
   android:oneshot="true">
3.  
   <item android:drawable="@drawable/rocket_thrust1" android:duration="200" />
4.  
   <item android:drawable="@drawable/rocket_thrust2" android:duration="200" />
5.  
   <item android:drawable="@drawable/rocket_thrust3" android:duration="200" />
6.  
   </animation-list>

我们可以看到，AnimationDrawable资源文件以<animation-list>元素为根，包含一系列的<Item>节点，每一个节点定义了一个帧(frame)及持续时常。

上述动画运行了3个帧，通过设置android:oneshot 属性(attribute)为true，动画会循环一次并停留在最后一帧，如果为false那么会轮询(loop)的运行动画

我们可以通过编码来加载播放动画：

1.  
   // Load the ImageView that will host the animation and
2.  
   // set its background to our AnimationDrawable XML resource.
3.  
   ImageView img = (ImageView)findViewById(R.id.spinning_wheel_image);
4.  
   img.setBackgroundResource(R.drawable.spin_animation);
5.  
    
6.  
   // Get the background, which has been compiled to an AnimationDrawable object.
7.  
   AnimationDrawable frameAnimation = (AnimationDrawable) img.getBackground();
8.  
    
9.  
   // Start the animation (looped playback by default).
10.  
    frameAnimation.start();

注意：AnimationDrawable. start()方法不能够在Activity的onCreate()方法中调用，因为AnimationDrawable还未完全的附加(attached)到Window,如果你不需要交互而立即播放动画，那么可以在onWindowFocusChanged() 方法中，这个方法会在你的Activity Windows获取焦点是触发。

结束语

至此我们的Drawable资源就介绍完了，当然还有好多的Drawable子类未进行介绍，感兴趣的可以关注SDK文档