基本上一个完整的APP都会有一个引导页，在APP首次安装或APP更新后第一次打开时显示，这个逻辑是很通用的，所以写成一个工具类，方便使用。
- APP启动页逻辑有三种情况:
- 当APP被首次安装后打开时显示引导页。
- 当APP更新版本后，第一次打开时显示引导页。
- 当APP再次启动时，跳过引导页。
- 工具类AppIntroUtil.java代码如下：
package cn.studyou.parchment.utils;
import android.content.Context;
import android.text.TextUtils;
/**
* 基本功能：app启动引导页控制
* 创建：王杰
* 创建时间：16/3/7
* 邮箱：w489657152@gmail.com
*/
public class AppIntroUtil {
public static final int LMODE_NEW_INSTALL = 1; //再次启动
public static final int LMODE_UPDATE = 2;//更新后第一次启动
public static final int LMODE_AGAIN = 3;//首次安装启动
public static final String SHARENAME= "lastVersion";
private boolean isOpenMarked = false;
private int launchMode = LMODE_AGAIN; //启动-模式
private static AppIntroUtil instance;
public static AppIntroUtil getThis() {
if (instance == null)
instance = new AppIntroUtil();
return instance;
}
/**
* 标记-打开app,用于产生-是否首次打开
* @param context
*/
public void markOpenApp(Context context) {
// 防止-重复调用
if (isOpenMarked)
return;
isOpenMarked = true;
String lastVersion = OperatingSharedPreferences.getString(context,SHARENAME,SHARENAME);
String thisVersion = VersionUtil.getVersion(context);
// 首次启动
if (TextUtils.isEmpty(lastVersion)) {
launchMode = LMODE_NEW_INSTALL;
OperatingSharedPreferences.setString(context,SHARENAME,SHARENAME,thisVersion);
}
// 更新
else if (VersionUtil.compareVersion(lastVersion,thisVersion)) {
launchMode = LMODE_UPDATE;
OperatingSharedPreferences.setString(context, SHARENAME, SHARENAME, thisVersion);
}
// 二次启动(版本未变)
else
launchMode = LMODE_AGAIN;
}
public int getLaunchMode() {
return launchMode;
}
/**
* 首次打开,新安装、覆盖(版本号不同)
* @return
*/
public boolean isFirstOpen() {
return launchMode != LMODE_AGAIN;
}
}
- AppIntroUtil.java中使用了另外一个工具类OperatingSharedPreferences.java，这个工具类就是对SharedPreferences进行的一个封装，方便使用，代码如下：
package cn.studyou.parchment.utils;
import android.content.Context;
import android.content.SharedPreferences;
import android.content.SharedPreferences.Editor;
/**
* 基本功能：存储和访问SharedPreferences
* 创建：王杰
* 创建时间：16/3/7
* 邮箱：w489657152@gmail.com
*/
public class OperatingSharedPreferences {
/**
*
* 基本功能：保存String类型数据到SharedPreferences
* 编写：王杰
*
* @param context
* @param name
* @param key
* @param value
*/
public static void setString(Context context,
String name, String key, String value) {
SharedPreferences sharedPreferences = context.getSharedPreferences(
name, Context.MODE_PRIVATE);
Editor editor = sharedPreferences.edit();// 获取编辑器
editor.putString(key, value);
editor.commit();// 提交修改
}
/**
*
* 基本功能：取得SharedPreferences中存储的String类型数据
* 编写：王杰
*
* @param context
* @param name
* @param key
* @return
*/
public static String getString(Context context,
String name, String key) {
SharedPreferences sharedPreferences = context.getSharedPreferences(
name, Context.MODE_PRIVATE);
String signature = sharedPreferences.getString(key, "");
return signature;
}
/**
*
* 基本功能：存储的Int类型数据到SharedPreferences
* 编写：王杰
*
* @param context
* @param name
* @param key
* @return
*/
public static void setInt(Context context,
String name, String key, int value) {
SharedPreferences sharedPreferences = context.getSharedPreferences(
name, Context.MODE_PRIVATE);
Editor editor = sharedPreferences.edit();// 获取编辑器
editor.putInt(key, value);
editor.commit();// 提交修改
}
/**
*
* 基本功能：取得SharedPreferences中存储的Int类型数据
* 编写：王杰
*
* @param context
* @param name
* @param key
* @return
*/
public static int getInt(Context context,
String name, String key) {
SharedPreferences sharedPreferences = context.getSharedPreferences(
name, Context.MODE_PRIVATE);
int signature = sharedPreferences.getInt(key, 0);
return signature;
}
}
- AppIntroUtil.java还使用了一个工具类VersionUtil.java，是用来比较APP版本。简要说明一下：使用这个工具类，我们是根据APP的versionName来进行判断的，规定versionName名字不少于三位（如：1.0.0，1.1.2）,compareVersion方法用来判断两个版本的大小，只比较前两位，若compareVersion方法返回true，则表示有新版本，否则为同一版本或低于当前版本。代码如下：
package cn.studyou.parchment.utils;
import android.content.Context;
import android.content.pm.PackageInfo;
import android.content.pm.PackageManager;
/**
* 基本功能：app版本号
* 创建：王杰
* 创建时间：16/3/7
* 邮箱：w489657152@gmail.com
*/
public class VersionUtil {
/**
* 获取版本号
*
* @return 当前应用的版本号
*/
public static String getVersion(Context context) {
try {
PackageManager manager = context.getPackageManager();
PackageInfo info = manager.getPackageInfo(context.getPackageName(), 0);
String version = info.versionName;
return version;
} catch (Exception e) {
e.printStackTrace();
return "";
}
}
/**
* 版本比较
*
* @param nowVersion app版本
* @param serverVersion 服务器版本
* @return
*/
public static boolean compareVersion(String nowVersion, String serverVersion) {
if (nowVersion != null && serverVersion != null) {
String[] nowVersions = nowVersion.split("\\.");
String[] serverVersions = serverVersion.split("\\.");
if (nowVersions != null && serverVersions != null && nowVersions.length > 1 && serverVersions.length > 1) {
int nowVersionsFirst = Integer.parseInt(nowVersions[0]);
int serverVersionFirst = Integer.parseInt(serverVersions[0]);
int nowVersionsSecond = Integer.parseInt(nowVersions[1]);
int serverVersionSecond = Integer.parseInt(serverVersions[1]);
if (nowVersionsFirst < serverVersionFirst) {
return true;
} else if (nowVersionsFirst == serverVersionFirst && nowVersionsSecond < serverVersionSecond) {
return true;
}
}
}
return false;
}
}
- 那么R如何使用这个启动控制类AppIntroUtil.java呢？
- 在Application类中初始化,我的Application 类名字是ParchmentApplication。
package cn.studyou.parchment;
import android.app.Application;
import cn.studyou.parchment.log.L;
import cn.studyou.parchment.utils.AppIntroUtil;
/**
* 基本功能：Application
* 创建：王杰
* 创建时间：16/3/7
* 邮箱：w489657152@gmail.com
*/
public class ParchmentApplication extends Application {
private static ParchmentApplication instance;
public static final boolean DEVELOPER_MODE = true;
public static ParchmentApplication getThis() {
if (instance == null)
instance = new ParchmentApplication();
return instance;
}
@Override
public void onCreate() {
super.onCreate();
//初始化日志工具
L.init(DEVELOPER_MODE);
AppIntroUtil.getThis().markOpenApp(getApplicationContext());
}
}
- 在APP启动控制Activity中使用:
package cn.studyou.parchment.activity;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import cn.studyou.parchment.R;
import cn.studyou.parchment.log.L;
import cn.studyou.parchment.utils.AppIntroUtil;
public class StartUpActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_start_up);
int launchMode = AppIntroUtil.getThis().getLaunchMode();
//自己的控制逻辑
if(launchMode == 3){
L.e("Again start!");
}else if(launchMode == 2){
L.e("Update start!");
}else if(launchMode == 1){
L.e("First start!");
}
}
}
