簡書地址:http://www.jianshu.com/p/ef486092c750
AndroidBasicProject是一個簡易的Android基礎項目,方便您快速進行開發。
包含以下內容:
- BaseActivity、BaseFragment
- Activity棧管理
- 異常信息收集
- 日誌打印
- 豐富的工具類
- Android6.0權限管理
- 通用適配器 請參考CommonAdapter
使用步驟
第一步:
dependencies {
compile 'com.classic.core:classic:2.2.1'
compile 'com.orhanobut:logger:1.15'
}
第二步:
public class YourApplication extends Application {
@Override public void onCreate() {
super.onCreate();
/**
* 默認配置
* 內部調用了: initDir() initLog(false) initExceptionHandler()三個方法
*/
BasicConfig.getInstance(this).init();
or
/**
* 自定義配置
* initDir() 初始化SDCard緩存目錄
* initLog() 初始化日誌打印
* initExceptionHandler() 初始化異常信息收集
*/
BasicConfig.getInstance(this)
.initDir() // or initDir(rootDirName)
.initExceptionHandler()
.initLog(true);
//其它初始化日誌方法:
/**
* @param tag 日誌標示
*/
initLog(tag)
/**
* @param tag 日誌標示
* @param isDebug true:打印全部日誌,false:不打印日誌
*/
initLog(tag, isDebug)
/**
* @param tag 日誌標示,可以爲空
* @param methodCount 顯示方法行數,默認爲:2
* @param isHideThreadInfo 是否顯示線程信息,默認顯示
* @param adapter 自定義log輸出
* @param isDebug true:打印全部日誌,false:不打印日誌
*/
initLog(tag, methodCount, isHideThreadInfo, adapter, isDebug)
}
}
代碼示例
Activity示例
public class TestActivity extends BaseActivity {
private RecyclerView mRecyclerView;
@Override public int getLayoutResId() {
return R.layout.activity_main;
}
//初始化一些數據
@Override public void initData() {
super.initData();
Intent intent = getIntent();
params = intent.getStringExtra(...);
}
//初始化view
@Override public void initView(Bundle savedInstanceState) {
super.initView(savedInstanceState);
mRecyclerView = (RecyclerView) findViewById(R.id.main_rv);
LinearLayoutManager manager = new LinearLayoutManager(this);
manager.setOrientation(LinearLayoutManager.VERTICAL);
mRecyclerView.setLayoutManager(manager);
mRecyclerView.setHasFixedSize(true);
mRecyclerView.setItemAnimator(new DefaultItemAnimator());
if(savedInstanceState == null){
/**
* 使用Fragment
* 參數1:被替換爲Fragment的視圖id
* 參數2:BaseFragment對象
*/
changeFragment(R.id.fragment_layout, new ImageFragment());
}
}
//以下爲可選方法,根據需要進行重載.
//方法執行順序:
//initPre() --> initData() --> initView(Bundle savedInstanceState) --> register()
//這裏可以註冊一些廣播、服務
@Override public void register() { }
//註銷廣播、服務,在onDestroy()內部執行
@Override public void unRegister() { }
//只有第一次纔會執行,這裏可以做一些界面功能引導
@Override public void onFirst() { }
//這個方法會在setContentView(...)方法之前執行
@Override public void initPre() { }
//view點擊事件統一處理
@Override public void viewClick(View v) { }
@Override public void showProgress() { }
@Override public void hideProgress() { }
}
Fragment示例
public class TestFragment extends BaseFragment {
private TextView mTitle;
@Override public int getLayoutResId() {
return R.layout.activity_listview_item;
}
@Override public void initView(View parentView, Bundle savedInstanceState) {
super.initView(parentView, savedInstanceState);
mTitle = (TextView) parentView.findViewById(R.id.item_title_tv);
}
//以下爲可選方法,根據需要進行重載.
//方法執行順序:
//initData() --> initView(View parentView, Bundle savedInstanceState) --> register()
//這裏可以註冊一些廣播、服務
@Override public void register() { }
//註銷廣播、服務, 在onDestroyView()內部執行
@Override public void unRegister() { }
//只有第一次纔會執行,這裏可以做一些界面功能引導
@Override public void onFirst() { }
@Override public void initData() { }
//view點擊事件統一處理
@Override public void viewClick(View v) { }
@Override public void showProgress() { }
@Override public void hideProgress() { }
//Fragment被切換到前臺時調用
@Override public void onFragmentShow() { }
//Fragment被切換到後臺時調用
@Override public void onFragmentHide() { }
}
啓動頁示例
public class SplashActivity extends BaseSplashActivity {
@Override protected void setSplashResources(List<SplashImgResource> resources) {
/**
* SplashImgResource參數:
* mResId - 圖片資源的ID。
* playerTime - 圖片資源的播放時間,單位爲毫秒。。
* startAlpha - 圖片資源開始時的透明程度。0-255之間。
* isExpand - 如果爲true,則圖片會被拉伸至全屏幕大小進行展示,否則按原大小展示。
*/
resources.add(new SplashImgResource(R.mipmap.splash,1500,100f,true));
resources.add(new SplashImgResource(R.mipmap.splash1,1500,100f,true));
resources.add(new SplashImgResource(R.mipmap.splash2,1500,100f,true));
}
@Override protected boolean isAutoStartNextActivity() {
return false;
}
@Override protected Class<?> nextActivity() {
return null;
//如果isAutoStartNextActivity設置爲true,這裏需要指定跳轉的activity
//return MainActivity.class;
}
@Override protected void runOnBackground() {
//這裏可以執行耗時操作、初始化工作
//請注意:如果執行了耗時操作,那麼啓動頁會等到耗時操作執行完纔會進行跳轉
//try {
// Thread.sleep(15 * 1000);
//} catch (InterruptedException e) {
// e.printStackTrace();
//}
}
}
Android6.0權限管理 更多使用方法點這裏
//以使用相機爲例,在Activity/Fragment添加以下代碼
private static final int REQUEST_CODE_CAMERA = 101;//請求相機權限的requestCode
@AfterPermissionGranted(REQUEST_CODE_CAMERA)
public void useCamera() {
if (EasyPermissions.hasPermissions(this, Manifest.permission.CAMERA)) {
ToastUtil.showToast(getApplicationContext(), "相機權限已授權,可以開始使用相機了");
} else {
//請求權限
EasyPermissions.requestPermissions(this, "應用需要訪問你的相機進行拍照",
REQUEST_CODE_CAMERA, Manifest.permission.CAMERA);
}
}
@Override
public void onPermissionsGranted(int requestCode, List<String> perms) {
//用戶授權成功
}
@Override
public void onPermissionsDenied(int requestCode, List<String> perms) {
//用戶拒絕授權
}
打印日誌
Logger.d(content);
Logger.e(content);
Logger.w(content);
Logger.v(content);
Logger.wtf(content);
//打印json數據
Logger.json(jsonContent);
//打印xml數據
Logger.xml(xmlContent);
注意事項:確保包裝選項是禁用的
工具類
- AppInfoUtil - 應用程序相關信息
- BitmapUtil - 圖像處理
- CloseUtil - 實現Closeable對象關閉工具類
- ConversionUtil - 單位轉換
- DataUtil - 數據非空判斷工具類
- DateUtil - 日期操作
- DeviceUtil - 設備信息
- DoubleClickExitHelper - 雙擊退出應用程序
- EditTextUtil - 文本輸入框工具類
- FileUtil - 文件操作
- HtmlUtil - HTML處理
- IntentUtil - 常用系統Intent
- IpUtil - IP工具類
- KeyBoardUtil - 鍵盤工具類
- MatcherUtil - 正則表達式
- MoneyUtil - 高精度數據計算
- NetworkUtil - 網絡狀態
- PackageUtil - 包管理
- ResourceUtil - 資源文件操作
- SDcardUtil - 存儲卡工具類
- SharedPreferencesUtil - 偏好參數存儲工具類
- StringUtil - 字符串處理工具類
- ToastUtil - Toast工具類
- ViewHolder - View複用工具類
- WifiHelper - wifi管理
- WindowUtil - 屏幕管理