|
|
/*
|
|
|
* 版权声明：此处声明代码的版权属于 MiCode 开放源代码社区，并指定了许可协议为 Apache License 2.0。
|
|
|
* 提供了许可协议的获取链接。
|
|
|
* 强调除非适用法律要求或书面同意，否则软件按 “原样” 分发，不提供任何形式的明示或暗示保证。
|
|
|
* 并指出许可协议中关于权限和限制的具体语言。
|
|
|
*/
|
|
|
|
|
|
package net.micode.notes.gtask.remote;
|
|
|
|
|
|
import android.app.Notification; // 导入 Notification 类，用于创建通知
|
|
|
import android.app.NotificationManager; // 导入 NotificationManager 类，用于管理通知
|
|
|
import android.app.PendingIntent; // 导入 PendingIntent 类，用于创建待定意图
|
|
|
import android.content.Context; // 导入 Context 类，用于获取系统服务等
|
|
|
import android.content.Intent; // 导入 Intent 类，用于启动活动等
|
|
|
import android.os.AsyncTask; // 导入 AsyncTask 类，用于在后台线程执行耗时操作
|
|
|
|
|
|
import net.micode.notes.R; // 导入资源文件
|
|
|
import net.micode.notes.ui.NotesListActivity; // 导入笔记列表活动类
|
|
|
import net.micode.notes.ui.NotesPreferenceActivity; // 导入笔记偏好设置活动类
|
|
|
|
|
|
|
|
|
/**
|
|
|
* GTaskASyncTask 类，继承自 AsyncTask，用于在后台线程执行 Google Tasks 同步操作。
|
|
|
*/
|
|
|
public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
|
|
|
|
|
|
private static int GTASK_SYNC_NOTIFICATION_ID = 5234235; // 定义同步通知的 ID
|
|
|
|
|
|
/**
|
|
|
* 定义同步完成的回调接口，用于在同步完成后执行相应操作。
|
|
|
*/
|
|
|
public interface OnCompleteListener {
|
|
|
void onComplete(); // 定义 onComplete 方法，具体实现由调用者提供
|
|
|
}
|
|
|
|
|
|
private Context mContext; // 应用程序上下文
|
|
|
private NotificationManager mNotifiManager; // 通知管理器
|
|
|
private GTaskManager mTaskManager; // Google Tasks 管理器
|
|
|
private OnCompleteListener mOnCompleteListener; // 同步完成回调接口实例
|
|
|
|
|
|
/**
|
|
|
* 构造函数，用于初始化 GTaskASyncTask 对象。
|
|
|
*
|
|
|
* @param context 应用程序上下文
|
|
|
* @param listener 同步完成回调接口实例
|
|
|
*/
|
|
|
public GTaskASyncTask(Context context, OnCompleteListener listener) {
|
|
|
mContext = context; // 保存上下文
|
|
|
mOnCompleteListener = listener; // 保存回调接口实例
|
|
|
mNotifiManager = (NotificationManager) mContext
|
|
|
.getSystemService(Context.NOTIFICATION_SERVICE); // 获取通知管理器实例
|
|
|
mTaskManager = GTaskManager.getInstance(); // 获取 Google Tasks 管理器实例
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 取消同步操作。
|
|
|
*/
|
|
|
public void cancelSync() {
|
|
|
mTaskManager.cancelSync(); // 调用 Google Tasks 管理器的 cancelSync 方法取消同步
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 发布进度信息。
|
|
|
*
|
|
|
* @param message 进度信息
|
|
|
*/
|
|
|
public void publishProgess(String message) {
|
|
|
publishProgress(new String[]{ // 调用 AsyncTask 的 publishProgress 方法发布进度
|
|
|
message
|
|
|
});
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 显示通知。
|
|
|
*
|
|
|
* @param tickerId 通知的 ticker 文本资源 ID
|
|
|
* @param content 通知内容
|
|
|
*/
|
|
|
private void showNotification(int tickerId, String content) {
|
|
|
Notification notification = new Notification(R.drawable.notification, mContext // 创建通知对象
|
|
|
.getString(tickerId), System.currentTimeMillis()); // 设置通知图标、ticker 文本和时间
|
|
|
notification.defaults = Notification.DEFAULT_LIGHTS; // 设置默认通知灯光
|
|
|
notification.flags = Notification.FLAG_AUTO_CANCEL; // 设置通知点击后自动取消
|
|
|
PendingIntent pendingIntent;
|
|
|
if (tickerId != R.string.ticker_success) { // 如果不是成功通知
|
|
|
pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext, // 创建指向 NotesPreferenceActivity 的待定意图
|
|
|
NotesPreferenceActivity.class), 0);
|
|
|
|
|
|
} else { // 如果是成功通知
|
|
|
pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext, // 创建指向 NotesListActivity 的待定意图
|
|
|
NotesListActivity.class), 0);
|
|
|
}
|
|
|
notification.setLatestEventInfo(mContext, mContext.getString(R.string.app_name), content, // 设置通知的详细信息
|
|
|
pendingIntent);
|
|
|
mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification); // 发出通知
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 在后台线程执行同步操作。
|
|
|
*
|
|
|
* @param unused 未使用的参数
|
|
|
* @return 同步操作的结果状态码
|
|
|
*/
|
|
|
@Override
|
|
|
protected Integer doInBackground(Void... unused) {
|
|
|
publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity // 发布登录进度信息
|
|
|
.getSyncAccountName(mContext)));
|
|
|
return mTaskManager.sync(mContext, this); // 执行同步操作并返回结果状态码
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 在 UI 线程更新进度。
|
|
|
*
|
|
|
* @param progress 进度信息数组
|
|
|
*/
|
|
|
@Override
|
|
|
protected void onProgressUpdate(String... progress) {
|
|
|
showNotification(R.string.ticker_syncing, progress[0]); // 显示同步中通知
|
|
|
if (mContext instanceof GTaskSyncService) { // 如果上下文是 GTaskSyncService 实例
|
|
|
((GTaskSyncService) mContext).sendBroadcast(progress[0]); // 发送广播更新进度
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 在 UI 线程处理同步结果。
|
|
|
*
|
|
|
* @param result 同步操作的结果状态码
|
|
|
*/
|
|
|
@Override
|
|
|
protected void onPostExecute(Integer result) {
|
|
|
if (result == GTaskManager.STATE_SUCCESS) { // 如果同步成功
|
|
|
showNotification(R.string.ticker_success, mContext.getString( // 显示成功通知
|
|
|
R.string.success_sync_account, mTaskManager.getSyncAccount()));
|
|
|
NotesPreferenceActivity.setLastSyncTime(mContext, System.currentTimeMillis()); // 更新最后同步时间
|
|
|
|
|
|
} else if (result == GTaskManager.STATE_NETWORK_ERROR) { // 如果是网络错误
|
|
|
showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_n |
