10. Android框架和工具之 AppMsg（消息提示）

1. AppMsg

　　优雅的弹出类似Toast的消息提示，支持3种状态Alert（警告），Confirm（确认）以及Info（消息）。

      

2. AppMsg使用：

（1）AppMsg下载地址：

https://github.com/johnkil/Android-AppMsg

（2）下载成功之后，解压如下：

（3）导入library 和 sample 分别导入Eclipse如下：

（4）首先我们来到主布局文件activity_main.xml，如下：

 <ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:fillViewport="true">

     <LinearLayout
         android:id="@+id/animated_root"
         android:layout_width="match_parent"
         android:layout_height="match_parent"
         android:gravity="center"
         android:orientation="vertical"
         android:animateLayoutChanges="true"
         android:padding="48dp">

         <TextView
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:layout_gravity="left"
             android:textAllCaps="true"
             android:text="@string/style"
             />
         <Spinner
             android:id="@+id/style_spnr"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:minHeight="48dp"
             android:spinnerMode="dropdown"
             android:entries="@array/styles"
             android:prompt="@string/style"
             />
         <TextView
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:layout_gravity="left"
             android:textAllCaps="true"
             android:text="@string/priority"
             />
         <Spinner
             android:id="@+id/priority_spnr"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:minHeight="48dp"
             android:spinnerMode="dropdown"
             android:entries="@array/priorities"
             android:prompt="@string/priority"
             />

         <CheckBox
             android:id="@+id/bottom"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:text="@string/bottom" />

         <LinearLayout
             android:id="@+id/alt_parent"
             android:visibility="gone"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:minHeight="48dp"
             android:orientation="vertical" />

         <CheckBox
             android:id="@+id/parent_chk"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:text="@string/custom_parent" />

         <EditText
             android:id="@+id/provided_txt"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:hint="@string/your_message_here"
             />

         <Button
             android:id="@+id/show"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:onClick="buttonClick"
             android:text="@string/show_appmsg" />

         <Button
             android:id="@+id/cancel_all"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:onClick="buttonClick"
             android:text="@string/cancel_all" />

     </LinearLayout>
 </ScrollView>

布局效果如下：

前面提到可以显示Alert、Confirm、Info三种消息样式，其实还可以显示自定义的消息样式，这里我们自定义一个消息样式为sticky.xml，如下：

 <?xml version="1.0" encoding="utf-8"?>

 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
                 android:layout_width="match_parent"
                 android:layout_height="wrap_content"
                 android:minHeight="48dp">

     <ImageButton
             android:id="@+id/remove_btn"
             android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:layout_alignParentRight="true"
             android:layout_centerVertical="true"
             android:minWidth="48dp"
             android:minHeight="48dp"
             android:src="@drawable/ic_action_cancel_inset"
             style="@style/SelectableItem"/>

     <TextView
             android:id="@android:id/message"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:layout_toLeftOf="@id/remove_btn"
             android:layout_centerVertical="true"
             android:gravity="center"
             android:padding="8dp"
             android:textColor="#ff222222"
             android:textIsSelectable="false"
             android:textSize="14sp"
             android:textStyle="bold"/>

 </RelativeLayout>

布局效果图，如下：

（5）在MainActivity工程之中找到主Activity，修改为extends Activity，如下：

 /*
  * Copyright 2012 Evgeny Shishkin
  *
  * 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.
  */

 package com.devspark.appmsg.sample;

 import android.app.Activity;
 import android.animation.LayoutTransition;
 import android.annotation.TargetApi;
 import android.os.Bundle;
 import android.view.View;
 import android.view.ViewGroup;
 import android.widget.CheckBox;
 import android.widget.CompoundButton;
 import android.widget.EditText;
 import android.widget.Spinner;

 import static android.os.Build.VERSION.SDK_INT;
 import static android.os.Build.VERSION_CODES.ICE_CREAM_SANDWICH;
 import static android.os.Build.VERSION_CODES.JELLY_BEAN;
 import static android.text.TextUtils.isEmpty;
 import static android.view.Gravity.BOTTOM;
 import static android.view.View.GONE;
 import static android.view.View.VISIBLE;

 import com.devspark.appmsg.AppMsg;

 /**
  * Sample of AppMsg library.
  *
  * @author hebao
  */
 public class  MainActivity  extends Activity {
     private static final int NORMAL_POSITION = 1;
     private static final int INFO_POSITION = 2;

     private int mMsgCount;
     private Spinner mStyle;
     private Spinner mPriority;
     private EditText mProvidedMsg;
     private CheckBox mBottom;
     private CheckBox mParent;
     private ViewGroup mAltParent;

     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);

         mProvidedMsg = (EditText) findViewById(R.id.provided_txt);
         mStyle = (Spinner) findViewById(R.id.style_spnr);
         mStyle.setSelection(INFO_POSITION);
         mPriority = (Spinner) findViewById(R.id.priority_spnr);
         mPriority.setSelection(NORMAL_POSITION);
         mBottom = (CheckBox) findViewById(R.id.bottom);
         mParent = (CheckBox) findViewById(R.id.parent_chk);
         mAltParent = (ViewGroup) findViewById(R.id.alt_parent);

         mParent.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() {
             @Override
             public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) {
                 mAltParent.setVisibility(isChecked ? VISIBLE : GONE);
                 mBottom.setVisibility(isChecked ? GONE : VISIBLE);
             }
         });

         if (SDK_INT >= JELLY_BEAN) {
             enableChangingTransition();
         }
     }

     /**
      * 指使用该注解的方法适用于系统版本Android 4.1
      * 注：Android 4.1的版本代号是Jelly Bean
      */
     @TargetApi(JELLY_BEAN)
     private void enableChangingTransition() {
         ViewGroup animatedRoot = (ViewGroup) findViewById(R.id.animated_root);
         animatedRoot.getLayoutTransition().enableTransitionType(LayoutTransition.CHANGING);
     }

     /**
      * Button onClick listener.
      *
      * @param v
      */
     public void buttonClick(View v) {
         switch (v.getId()) {
             case R.id.show:
                 showAppMsg();
                 break;
             case R.id.cancel_all:
                 AppMsg.cancelAll(this);
                 break;
             default:
                 return;
         }
     }

     /**
      * 显示App Message
      */
     private void showAppMsg() {
         mMsgCount++;
         final int styleSelected = mStyle.getSelectedItemPosition();
         final int priority = positionToPriority(mPriority.getSelectedItemPosition());
         final CharSequence providedMsg = mProvidedMsg.getText();
         final CharSequence msg = isEmpty(providedMsg)
                 ? new StringBuilder().append(mStyle.getSelectedItem())
                 .append(" ").append(mPriority.getSelectedItem())
                 .append(" msg#").append(mMsgCount).toString()
                 : providedMsg;
         final AppMsg.Style style;
         boolean customAnimations = false;
         AppMsg provided = null;
         switch (styleSelected) {
             case 0:
                 style = AppMsg.STYLE_ALERT;
                 break;
             case 1:
                 style = AppMsg.STYLE_CONFIRM;
                 break;
             case 3:
                 style = new AppMsg.Style(AppMsg.LENGTH_SHORT, R.color.custom);
                 customAnimations = true;
                 break;
             case 4:
                 style = new AppMsg.Style(AppMsg.LENGTH_STICKY, R.color.sticky);
                 provided = AppMsg.makeText(this, msg, style, R.layout.sticky);
                 provided.getView()
                         .findViewById(R.id.remove_btn)
                         .setOnClickListener(new CancelAppMsg(provided));
                 break;
             default:
                 style = AppMsg.STYLE_INFO;
                 break;
         }
         // create {@link AppMsg} with specify type
         AppMsg appMsg = provided != null ? provided : AppMsg.makeText(this, msg, style);
         appMsg.setPriority(priority);
         if (mParent.isChecked()) {
             appMsg.setParent(mAltParent);
         } else {
             if (mBottom.isChecked()) {
                 appMsg.setLayoutGravity(BOTTOM);
             }
         }

         if (customAnimations) {
             appMsg.setAnimation(android.R.anim.slide_in_left, android.R.anim.slide_out_right);
         }
         appMsg.show();

     }

     private static int positionToPriority(int selectedItemPosition) {
         switch (selectedItemPosition) {
             case 0:
                 return AppMsg.PRIORITY_HIGH;
             case 2:
                 return AppMsg.PRIORITY_LOW;
             default:
                 return AppMsg.PRIORITY_NORMAL;
         }
     }

     @Override
     protected void onPause() {
         super.onPause();
         // This is optional for 14+,
         // also you may want to call it at your later convenience, e.g. onDestroy
         if (SDK_INT < ICE_CREAM_SANDWICH) {
             AppMsg.cancelAll(this);
         }
     }

     static class CancelAppMsg implements View.OnClickListener {
         private final AppMsg mAppMsg;

         CancelAppMsg(AppMsg appMsg) {
             mAppMsg = appMsg;
         }

         @Override
         public void onClick(View v) {
             mAppMsg.cancel();
         }
     }
 }

部署到模拟器上，如下：