作者: zgh149

MVC Pattern in Android

概述

(關於 MVC 在 POSA 的說明可以參考這篇，本篇是套用 MVC 於 Android 的描述和實作)
MVC 將架構分為 3 個部分，分別為 Model(模型層)，View(視圖層)，Controller(控制層)
View(視圖層):負責與使用者互動並顯示來自模型層的資料。
Controller(控制層):負責根據來自視圖層的互動訊息，指揮模型層更新資料或指揮視圖層重新載入模型層的資料。
Model(模型層):負責管理視圖邏輯和業務邏輯，提供網路和資料庫的監聽和修改介面。

設計理念

通常視圖邏輯發生修改的機會高於業務邏輯發生修改的機會，因此希望當這兩者發生變化時不會影響彼此(業務邏輯發生變化時不會影響視圖邏輯，視圖邏輯不會影響業務邏輯)。
在 MVC 架構中，View 依賴於 Model 和 Controller，Controller 依賴 View 和 Model，Model 完全獨立不依賴其它兩者。
View 接受使用者輸入事件並轉發給 Controller ，再根據 Controller 的指令顯示 Model 的資料。
Model 提供資料並更新資料，View 的顯示內容就是來自 Model 提供的資料，Controller 也會更新 Model 的資料。
Controller 根據來自 View 的使用者輸入事件，發出指令給 Model 更新資料並通知 View 重新載入 Model 的資料。
根據 Controller 更新 Model 資料的方式，可以分為主動和被動。因此 MVC 也可分為主動模式(Active)和被動模式(Passive)。

被動(Passive)模式

在被動模式中，Controller 是唯一可以更改 Model 資料的角色，而 View 只能根據 Controller 的指令被動從 Model 取得資料並顯示內容。
Controller 控制整個流程的更新過程，根據輸入事件被動的通知 Model 更改資料再通知 View 顯示資料。
流程如下:
使用者觸發 View 的輸入事件，事件轉發給 Controller，Controller 通知 Model 更改資料。當 Model 資料更改完成後，Controller 再通知 View 取得 Model 的資料並顯示內容。

被動模式實作

以簡單的亂數產生器作為範例。
首先從 View 開始。
View 就是 Activity，Activity 只有 1 個 Button 用來產生亂數，以及 1 個 TextView 用來顯示亂數。
View 會持有 Model 和 Controller 的參考，Model 參考用來取得資料並顯示內容，而 Controller 參考用來轉發使用者輸入事件。

public class MVCPassiveActivity extends AppCompatActivity implements OnClickListener {
  private Button mRollIt;
  private TextView mRollNumber;
  private MVCPassiveController mController;
  private MVCPassiveModel mModel;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.mvc_passive_activity);
    initData();
    initUI();
  }
  private void initData() {
    mModel = new MVCPassiveModel();
    mController = new MVCPassiveController(this, mModel);
  }
  private void initUI() {
    mRollIt = findViewById(R.id.mvc_passive_roll_it);
    mRollIt.setOnClickListener(this);
    mRollNumber = findViewById(R.id.mvc_passive_show_roll_number);
  }
  @Override
  public void onClick(View view) {
    int uiID = view.getId();
    switch (uiID) {
      case R.id.mvc_passive_roll_it:
        mController.rollIt();
        break;
    }
  }
  public void update() {
    mRollNumber.setText("" + mModel.getRandomNumber());
  }
}

需要注意的是在 initData 方法中初始化 Model 以及 Controller。而在 MVCPassiveController 的建構式中會去關連 View 和 Model。
在 onClick 方法中會去轉發使用者輸入事件給 Controller，而 Controller 的 rollIt 方法就是去通知 Model 更改資料。
最後在 update 方法就是從 Model 取得資料並顯示內容。
接著是 Controller ，Controller 會持有 View 和 Model 的參考並在建構式中關連起來。

public class MVCPassiveController {
  private MVCPassiveActivity mView;
  private MVCPassiveModel mModel;
  public MVCPassiveController(MVCPassiveActivity view, MVCPassiveModel model) {
    mView = view;
    mModel = model;
  }
  public void rollIt() {
    mModel.rollOnce();
    mView.update();
  }
}

在 rollIt 方法首先通知 Model 更改資料，接著再通知 View 取得 Model 的資料並顯示內容。
最後是 Model，Model 完全獨立不依賴於其它層，唯一需要注意的是實際上的 Model 應該是 repository 其中會有取得本地端和遠端資料的元件，本篇的範例相對簡單的多。

public class MVCPassiveModel {
  private int mRandomNumber;
  public void rollOnce() {
    mRandomNumber = new Random().nextInt(100);
  }
  public int getRandomNumber() {
    return mRandomNumber;
  }
}

主動(Active)模式

主動模式會應用觀察者模式(Observer Pattern) 來控制整個流程。首先 Model 就是主題(Subject)，而 View 和 Controller 則都是觀察者(Observer)。
當 Model 發生變化，其註冊的觀察者(View & Controller)都會自動收到通知，Controller 仍然是通知 Model 資料變化的角色，和被動模式的差別是 Controller 不再需要通知 View 更新資料，因為當 Model 的資料發生變化時，View 會自動收到通知。
流程如下:
使用者觸發 View 的輸入事件，事件轉發給 Controller，Controller 通知 Model 更改資料。
當 Model 資料更改完成後，觀察者們(View & Controller)都會自動收到通知並進行相關處理。

主動模式實作

也是以簡單的亂數產生器作為範例。
首先建立觀察者介面，觀察者必須繼承該介面，並實作介面中的 update 方法，該方法的參數就是更新資料後的 Model。

public interface IObserver {
  public void update(MVCActiveModel mvcActiveModel);
}

接著實作 Model，Model 就是主題，會持有 1 個觀察者們的 list。對該 Model 有興趣的觀察者都會註冊成為該主題的觀察者。

public class MVCActiveModel {
  private ArrayList<IObserver> mObservers = new ArrayList<>();
  private int mRandomNumber;
  public void rollOnce() {
    mRandomNumber = new Random().nextInt(100);
    notifyObservers();
  }
  public int getRandomNumber() {
    return mRandomNumber;
  }
  public void addObserver(IObserver observer) {
    mObservers.add(observer);
  }
  public void removeObserver(IObserver observer) {
    if (mObservers.contains(observer)) {
      mObservers.remove(observer);
    }
  }
  private void notifyObservers() {
    int sizeOfObservers = mObservers.size();
    for (int i = 0; i < sizeOfObservers; ++i) {
      mObservers.get(i).update(this);
    }
  }
}

notifyObservers 方法就是通知所有的觀察者，主題(Model)的資料已經發生變化，觀察者會收到通知，並自行決定如何處理已變化的資料。
而 rollOnce 方法就是改變資料並通知觀察者們的觸發點。
接著是 Controller，Controller 也是觀察者之一，因此需要繼承 IObserver。
而在建構式中會將自己註冊到 Model 的 Observer list 中。

public class MVCActiveController implements IObserver {
  private MVCActiveActivity mView;
  private MVCActiveModel mModel;
  public MVCActiveController(MVCActiveActivity view, MVCActiveModel model) {
    mView = view;
    mModel = model;
    mModel.addObserver(this);
  }
  public void rollIt() {
    mModel.rollOnce();
  }
  @Override
  public void update(MVCActiveModel model) {
  }
}

最後是 View，View 也是觀察者所以需要繼承 IObserver，並實作 update 方法，在該方法中取得更新後的 Model 並顯示其資料內容。
而在 initData 方法內會將自己註冊為 Model 的觀察者。

public class MVCActiveActivity extends AppCompatActivity implements OnClickListener, IObserver {
  //Main UI
  private Button mRollIt;
  private TextView mRollNumber;
  private MVCActiveController mController;
  private MVCActiveModel mModel;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.mvc_active_activity);
    initData();
    initUI();
  }
  private void initData() {
    mModel = new MVCActiveModel();
    mModel.addObserver(this);
    mController = new MVCActiveController(this, mModel);
  }
  private void initUI() {
    mRollIt = findViewById(R.id.mvc_active_roll_it);
    mRollIt.setOnClickListener(this);
    mRollNumber = findViewById(R.id.mvc_active_show_roll_number);
  }
  @Override
  public void onClick(View view) {
    int uiID = view.getId();
    switch (uiID) {
      case R.id.mvc_active_roll_it:
        mController.rollIt();
        break;
    }
  }
  @Override
  public void update(MVCActiveModel model) {
    mRollNumber.setText("" + model.getRandomNumber());
  }
}

變化

如果希望 Controller 完全不包含 Android 的視圖元素，可以建立一個 IView 介面並讓Activity 繼承它，而 Controller 持有對象的型別從 Activity 改為 IView，而原本對 Activity的操作都改為對 IView 的操作，如下
IView.java

public interface IView {
  public void update();
}

MVCPassiveActivity.java

public class MVCPassiveActivity extends AppCompatActivity implements OnClickListener, IView {
...
  @Override
  public void update() {
    mRollNumber.setText("" + mModel.getRandomNumber());
  }
}

MVCPassiveController.java

public class MVCPassiveController {
  private IView mView;
  public MVCPassiveController(IView view, MVCPassiveModel model) {
    mView = view;
    ...
  }
  public void rollIt() {
    ...
    mView.update();
  }
}

以上為MVC Pattern in Android。

以下為 MVP 相關內容

Model in todo-mvp

MVP Pattern in Android

標籤 Android

Android

Activity 的啟動模式(LaunchMode)紀錄

文章作者作者: zgh149
文章發佈日期 10 4 月, 2019

概述

Activity 的啟動模式主要包含 4 種:
Standard(標準模式，預設)，SingleTop(棧頂重用)，SingleTask(棧內重用)，
SingleInstance(單例模式)。
Standard 每次啟動都會建立新的 Activity 實體，其它 3 種會根據情況選擇新增或
是重用 Activity 實體。
建立新實體的生命週期為 onCreate -> onStart -> onResume
重用舊實體的生命週期為 onNewIntent -> onResume

如何使用啟動模式A.

在 AndroidManifest.xml 中可以透過設定 launchMode 設定不同的啟動模式
使用 taskAffinity 並加入套件名稱便可以設定不同的栈，預設棧為目前套件名
稱，taskAffinity 只能用於 SingleTop, SingleTask, SingleInstance

1.Standard(標準):

啟動 Activity 的預設模式，當使用 Standard 每次都會產生新的實體。

2.SingleTop(棧頂重用):

當要啟動的 Activity 在棧頂，則重用該實體。若不在棧頂則建立新的實體(建立完成後該實體位於棧頂)。
啟動的生命週期:
D: onCreate
D: onStart
D: onResume
重用的生命週期
D: onPause
D: onNewIntent
D: onResume

3.SingleTask(棧內重用)

A.沒有設定 taskAffinity (情況較為簡單):
1.當要啟動的 Activity 位於棧頂時，重用該實體，不會建立新的實體。
重用的生命週期
D: onPause
D: onNewIntent
D: onResume
2.當要啟動的 Activity 位於棧內時，會重用該實體並清除該實體上方的所有其它Activity。(此時該啟動的 Activity 位於棧頂)。
重用的生命週期
D: onPause
D: onNewIntent
D: onResume
B.有設定 taskAffinity:(注意 taskAffinity 只能用於 SingleTop, SingleTask, SingleInstance)
當設定 taskAffinity 時有幾個重點:
1.被啟動的 Activity 會跟著啟動的 Activity 處於同一個棧中。
2.有一些操作會切換棧，如按下 home key，再點擊 app icon 會重用預設栈
3.當從棧退出 Activity，會優先退出同一個棧的 Activity，而當退完同一個棧的所有 Activity，會切換回桌面，不會啟動另一個棧。
以範例說明:
FirstActivity 啟動 SecondActivity，SecondActivity 啟動 ThirdActivity(SingleTask, 不同棧，棧名為 another.stack))啟動 FourthActivity (預設)
此時 FirstActivity 和 SecondActivity 位於預設棧，而 ThirdActivity 和 FourthActivity 位於 another.stack 棧。顯示在螢幕最上方的為 FourthActivity。
2個走向:
1.按下 home key 再點擊 app icon，此時會啟動預設棧，因此顯示在螢幕上的為 SecondActivity，點擊 back key(SecondActivity 銷毀)，顯示 FirstActivity，點擊 back key(FirstActivity 銷毀)，回到桌面。
(注意此時 ThirdActivity 和 FourthActivity 還未銷毀，保存在記憶體中)
2.按下 back key(FourthActivity 銷毀)，顯示 ThirdActivity，按下 back key(ThirdActivity 銷毀)，顯示 SecondActivity，按下 back key( SecondActivity 銷毀)，顯示 FirstActivity，按下 back key(FirstActivity 銷毀)，回到桌面。

重點:

1.若設定新的任務棧，有些操作會啟動不同的任務棧，這些操作可能會讓使用者感覺混淆。
2.當啟動新的 Activity 而產生新的任務棧時，畫面切換的動畫會不同。

4.SingleInstance(單例實體)

啟動設定為單例實體的 Activity 時，會建立單獨的栈且該棧無法加入其它的 Activiity，之後都會重用該實體。
以範例說明:
FirstActivity 啟動 SecondActivity，SecondActivity 啟動 FifthActivity(單例實體)，FifthActivity 啟動 FourthActivity。
(此時有 2 個棧，預設棧有 FirstActivity，SecondActivity，FourthActivity。另一個棧只有 FifthActivity)
2個走向:
1.按下 back key(FourthActivity 銷毀)，顯示 SecondActivity
(注意這裡因為出棧的規則是同一個棧的 Activity 會先出完，因此顯示的是 SecondActivity，而不是 FifthActivity)，按下 back key(SecondActivity 銷毀)，顯示 FirstActivity，按下 back key(FirstActivity 銷毀)，顯示 FifthActivity，按下 back key(FifthActivity 銷毀)，回到桌面。
2.FourthActivity 啟動 FifthActivity，FifthActivity 啟動 FourthActivity，按下 back key(FourthActivity 銷毀)，顯示 FourthActivity，按下 back key(FourthActivity 銷毀)，顯示 SecondActivity，按下 back key(SecondActivity 銷毀)，顯示FirstActivity，按下 back key(FirstActivity 銷毀)，顯示 FifthActivity，按下back key(FifthActivity 銷毀)，回到桌面。

重點:

1.設定為單例實體之後一定都會重用實體。
2.單例實體的 Activity 啟動另一個 Activity 後，被啟動的 Activity 不會加入到單例實體的棧中，而會加到預設棧。
3.出棧規則也是先出完同一個棧，待同一個棧的所有的 Activity 出完之後再切換到另一個棧。

如何使用啟動模式B.

呼叫 startActivity 方法時使用參數 intent 設定啟動標幟(flag)，如下

intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

常用的標幟如下:
1.FLAG_ACTIVITY_SINGLE_TOP: 和棧頂重用(SingleTop)相同。
2.FLAG_ACTIVITY_NEW_TASK: 和棧內重用(SingleTask)相同，但不會清除該 Activity以上的其它 Activity。
3.FLAG_ACTIVITY_CLEAR_TOP:如果是棧內重用的啟動模式，則會清除棧上其它的 Activity 並重用實體且呼叫 onNewIntent 方法。
如果是預設的啟動模式則會清除自己和其它的實體，再重新建立，呼叫 onCreate

在 AndroidManifest.xml 設定和在 startActivity 的 intent 設定的不同點:

1.2 種方式選擇 1 個使用即可。如果同時使用，startActivity 的優先級較高會蓋過AndroidManifest.xml 的設定
2.startActivity 無法設定 SingleInstance 模式
3.AndroidManifest.xml 只有 SingleTask 具有清除頂部的功能，但 startActivity 可以透過設定 FLAG_ACTIVITY_CLEAR_TOP 清除頂部，在標準的啟動模式也可以使用
4.當使用 startActivityForResult 啟動 Activity 時不會重用實體，會重複建立多個實體，因此使用 startActivityForResult 時不建議同時使用會重用實體的啟動模式(SingleTop, SingleTask, SingleInstance)

總結:

1.SingleTop(棧頂重用)
當要啟動的 Activity 位於棧頂時重用該實體。如果不在棧頂則建立新的實體。
2.SingleTask(棧內重用)
當要啟動的 Activity 位於棧頂時重用該實體。如果不在棧頂則清除該 Activity 以上的其它 Activity。
3.SingleInstance(單例實體)
當要啟動的 Activity 不存在時直接建立新的任務棧並放入該 Activity，之後都會重用該 Activity。
4.任務棧的切換
SingleTop, SingleTask, SingleInstance 都可透過 taskAffinity 建立新的任務棧，當使用 back key退出 Activity 時會先把同一個棧的 Activity 全部退出。切換任務棧可能會搞混。
5.設定啟動模式的方法
有 2 種，可在 AndroidManifest.xml 以及 startActivity 的intent。startActivity 的優先性大於 AndroidManifest.xml。
6.startActivityForResult 建議不要和會重用實體的模式同時使用，因為該方法無法重用實體。

Source Code:
FirstActivity.java

public class FirstActivity extends AppCompatActivity implements OnClickListener {
  private TextView mActivityInstanceID;
  private Button mLaunchSecondActivity;
  private Button mLaunchFirstActivity;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.first_activity);
    mLaunchSecondActivity = findViewById(R.id.first_activity_launch_second_activity);
    mLaunchSecondActivity.setOnClickListener(this);
    mLaunchFirstActivity = findViewById(R.id.first_activity_launch_first_activity);
    mLaunchFirstActivity.setOnClickListener(this);
    mActivityInstanceID = findViewById(R.id.first_activity_activity_instance_id);
    mActivityInstanceID.setText(this.toString());
  }
  @Override
  public void onClick(View view) {
    int uiID = view.getId();
    switch (uiID){
      case R.id.first_activity_launch_first_activity:
        Intent launchFirstActivityIntent = new Intent(this, FirstActivity.class);
        startActivity(launchFirstActivityIntent);
        break;
      case R.id.first_activity_launch_second_activity:
        Intent launchSecondActivityIntent = new Intent(this, SecondActivity.class);
        startActivity(launchSecondActivityIntent);
        break;
   }
  }
}

SecondActivity.java

public class SecondActivity extends AppCompatActivity implements OnClickListener {
  private static final String TAG = SecondActivity.class.getSimpleName();
  private TextView mActivityInstanceID;
  private Button mLaunchSecondActivity;
  private Button mLaunchThirdActivity;
  private Button mLaunchFifthActivity;
  private int mCount;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    Log.d(TAG, "onCreate");
    super.onCreate(savedInstanceState);
    setContentView(R.layout.second_activity);
    mLaunchSecondActivity = findViewById(R.id.second_activity_launch_second_activity);
    mLaunchSecondActivity.setOnClickListener(this);
    mLaunchThirdActivity = findViewById(R.id.second_activity_launch_third_activity);
    mLaunchThirdActivity.setOnClickListener(this);
    mLaunchFifthActivity = findViewById(R.id.second_activity_launch_fifth_activity);
    mLaunchFifthActivity.setOnClickListener(this);
    mActivityInstanceID = findViewById(R.id.second_activity_activity_instance_id);
    mActivityInstanceID.setText(this.toString());
  }
  @Override
  protected void onStart() {
    Log.d(TAG, "onStart");
    super.onStart();
  }
  @Override
  protected void onResume() {
    Log.d(TAG, "onResume");
    super.onResume();
  }
  @Override
  protected void onPause() {
    Log.d(TAG, "onPause");
    super.onPause();
  }
  @Override
  protected void onStop() {
    Log.d(TAG, "onStop");
    super.onStop();
  }
  @Override
  protected void onDestroy() {
    Log.d(TAG, "onDestroy");
    super.onDestroy();
  }
  @Override
  protected void onRestart() {
    Log.d(TAG, "onRestart");
    super.onRestart();
  }
  @Override
  protected void onSaveInstanceState(Bundle outState) {
    Log.d(TAG, "onSaveInstanceState");
    super.onSaveInstanceState(outState);
  }
  @Override
  protected void onRestoreInstanceState(Bundle savedInstanceState) {
    Log.d(TAG, "onRestoreInstanceState");
    super.onRestoreInstanceState(savedInstanceState);
  }
  @Override
  protected void onNewIntent(Intent intent) {
    Log.d(TAG, "onNewIntent");
    super.onNewIntent(intent);
    mCount++;
    Log.d(TAG, "mcount:"+mCount);
  }
  @Override
  public void onClick(View view) {
    int uiID = view.getId();
    switch (uiID){
      case R.id.second_activity_launch_second_activity:
        Intent launchSecondActivityIntent = new Intent(this, SecondActivity.class);
        startActivity(launchSecondActivityIntent);
        break;
      case R.id.second_activity_launch_third_activity:
        Intent launchThirdActivityIntent = new Intent(this, ThirdActivity.class);
        startActivity(launchThirdActivityIntent);
        break;
      case R.id.second_activity_launch_fifth_activity:
        Intent launchFifthActivityIntent = new Intent(this, FifthActivity.class);
        startActivity(launchFifthActivityIntent);
        break;
    }
  }
}

ThirdActivity.java

public class ThirdActivity extends AppCompatActivity implements OnClickListener {
  private static final String TAG = ThirdActivity.class.getSimpleName();
  private Button mLaunchSecondActivity;
  private Button mLaunchFirstActivity;
  private Button mLaunchThirdActivity;
  private Button mLaunchFourthActivity;
  private TextView mActivityInstanceID;
  private int mReuseActivityCount;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    Log.d(TAG, "onCreate");
    super.onCreate(savedInstanceState);
    setContentView(R.layout.third_activity);
    mLaunchSecondActivity = findViewById(R.id.third_activity_launch_second_activity);
    mLaunchSecondActivity.setOnClickListener(this);
    mLaunchFirstActivity = findViewById(R.id.third_activity_launch_first_activity);
    mLaunchFirstActivity.setOnClickListener(this);
    mActivityInstanceID = findViewById(R.id.third_activity_activity_instance_id);
    mActivityInstanceID.setText(this.toString());
    mLaunchThirdActivity = findViewById(R.id.third_activity_launch_third_activity);
    mLaunchThirdActivity.setOnClickListener(this);
    mLaunchFourthActivity = findViewById(R.id.third_activity_launch_fourth_activity);
    mLaunchFourthActivity.setOnClickListener(this);
  }
  @Override
  protected void onStart() {
    Log.d(TAG, "onStart");
    super.onStart();
  }
  @Override
  protected void onResume() {
    Log.d(TAG, "onResume");
    super.onResume();
  }
  @Override
  protected void onPause() {
    Log.d(TAG, "onPause");
    super.onPause();
  }
  @Override
  protected void onStop() {
    Log.d(TAG, "onStop");
    super.onStop();
  }
  @Override
  protected void onDestroy() {
    Log.d(TAG, "onDestroy");
    super.onDestroy();
  }
  @Override
  protected void onRestart() {
    Log.d(TAG, "onRestart");
    super.onRestart();
  }
  @Override
  protected void onSaveInstanceState(Bundle outState) {
    Log.d(TAG, "onSaveInstanceState");
    super.onSaveInstanceState(outState);
  }
  @Override
  protected void onRestoreInstanceState(Bundle savedInstanceState) {
    Log.d(TAG, "onRestoreInstanceState");
    super.onRestoreInstanceState(savedInstanceState);
  }
  @Override
  protected void onNewIntent(Intent intent) {
    Log.d(TAG, "onNewIntent");
    super.onNewIntent(intent);
    mReuseActivityCount++;
    Log.d(TAG, "mReuseActivityCount:"+mReuseActivityCount);
  }
  @Override
  public void onClick(View view) {
    int uiID = view.getId();
    switch(uiID){
      case R.id.third_activity_launch_third_activity:
        Intent launchThirdActivityIntent = new Intent(this, ThirdActivity.class);
        startActivity(launchThirdActivityIntent);
        break;
      case R.id.third_activity_launch_second_activity:
        Intent launchSecondActivityIntent = new Intent(this, SecondActivity.class);
        startActivity(launchSecondActivityIntent);
        break;
      case R.id.third_activity_launch_first_activity:
        Intent launchFirstActivityIntent = new Intent(this, FirstActivity.class);
        startActivity(launchFirstActivityIntent);
        break;
      case R.id.third_activity_launch_fourth_activity:
        Intent launchFourthActivityIntent = new Intent(this, FourthActivity.class);
        startActivity(launchFourthActivityIntent);
        break;
    }
  }
}

FourthActivity.java

public class FourthActivity extends AppCompatActivity implements OnClickListener {
  private static final String TAG = FourthActivity.class.getSimpleName();
  private TextView mActivityInstanceID;
  private Button mLaunchFifthActivity;
  private int mReuseActivityCount;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    Log.d(TAG, "onCreate");
    super.onCreate(savedInstanceState);
    setContentView(R.layout.fourth_activity);
    mActivityInstanceID = findViewById(R.id.fourth_activity_activity_instance_id);
    mActivityInstanceID.setText(this.toString());
    mLaunchFifthActivity = findViewById(R.id.fourth_activity_launch_fifth_activity);
    mLaunchFifthActivity.setOnClickListener(this);
  }
  @Override
  protected void onStart() {
    Log.d(TAG, "onStart");
    super.onStart();
  }
  @Override
  protected void onResume() {
    Log.d(TAG, "onResume");
    super.onResume();
  }
  @Override
  protected void onPause() {
    Log.d(TAG, "onPause");
    super.onPause();
  }
  @Override
  protected void onStop() {
    Log.d(TAG, "onStop");
    super.onStop();
  }
  @Override
  protected void onDestroy() {
    Log.d(TAG, "onDestroy");
    super.onDestroy();
  }
  @Override
  protected void onRestart() {
    Log.d(TAG, "onRestart");
    super.onRestart();
  }
  @Override
  protected void onSaveInstanceState(Bundle outState) {
    Log.d(TAG, "onSaveInstanceState");
    super.onSaveInstanceState(outState);
  }
  @Override
  protected void onRestoreInstanceState(Bundle savedInstanceState) {
    Log.d(TAG, "onRestoreInstanceState");
    super.onRestoreInstanceState(savedInstanceState);
  }
  @Override
  protected void onNewIntent(Intent intent) {
    Log.d(TAG, "onNewIntent");
    super.onNewIntent(intent);
    mReuseActivityCount++;
    Log.d(TAG, "mReuseActivityCount:" + mReuseActivityCount);
  }
  @Override
  public void onClick(View view) {
    int uiID = view.getId();
    switch(uiID){
      case R.id.fourth_activity_launch_fifth_activity:
        Intent launchFifthActivityIntent = new Intent(this, FifthActivity.class);
        startActivity(launchFifthActivityIntent);
        break;
    }
  }
}

FifthActivity.java

public class FifthActivity extends AppCompatActivity implements OnClickListener {
  private Button mLaunchFourthActivity;
  private TextView mActivityInstanceID;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.fifth_activity);
    mActivityInstanceID = findViewById(R.id.fifth_activity_activity_instance_id);
    mActivityInstanceID.setText(this.toString());
    mLaunchFourthActivity = findViewById(R.id.fifth_activity_launch_fourth_activity);
    mLaunchFourthActivity.setOnClickListener(this);
  }
  @Override
  public void onClick(View view) {
    int uiID = view.getId();
    switch(uiID){
      case R.id.fifth_activity_launch_fourth_activity:
        Intent launchFourthActivityIntent = new Intent(this, FourthActivity.class);
        startActivity(launchFourthActivityIntent);
        break;
    }
  }
}

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  package="com.codefoxx.activitylaunchmode">
  <application
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/AppTheme">
    <activity
      android:label="FifthActivity"
      android:launchMode="singleInstance"
      android:name=".FifthActivity">
    </activity>
    <activity
      android:label="FouthActivity"
      android:name=".FourthActivity">
    </activity>
    <activity
      android:label="ThirdActivity"
      android:launchMode="singleTask"
      android:name=".ThirdActivity"
      android:taskAffinity="another.stack">
    </activity>
    <activity
      android:label="SecondActivity"
      android:launchMode="singleTop"
      android:name=".SecondActivity">
    </activity>
    <activity
      android:label="FirstActivity"
      android:name=".FirstActivity">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>
  </application>
</manifest>

標籤 Android

Android

Activity 生命週期紀錄

文章作者作者: zgh149
文章發佈日期 8 4 月, 2019

概要:

生命週期主要包含 6 種狀態: onCreate, onStart, onResume, onPause, onStop, onDestroy。
各種狀態意義為
onCreate 代表 Activity 的建立:
當系統初次建立 Activity 時 onCreate 方法會被呼叫，此時會進入 Created 狀態，應該在這個方法中實作首次啟動的邏輯，如綁定資料到清單中，關聯ViewModel和Activity，初始化變數。
onCreate方法會傳入 bundle 參數，bundle參數會包含上一次Activity儲存的資料，若Activity之前還未存在過，則bundle參數為null。
當onCreate方法結束後，Activity 會進入 Started 狀態，系統將會呼叫onStart方法。
onStart 代表 Activity 的啟動
當Activity進入Started狀態時，系統將會呼叫 onStart 方法。onStart方法會讓 Activity 變得可見，但還無法和使用者互動。onStart會很快的執行完成，完成後Activity會進入 Resumed 狀態。
onResume 代表 Activity 的恢復
當 Activity 進入 Resumed 狀態，系統將會呼叫onResume方法，onResume方法會讓Activity聚焦並讓使用者可以和Activity互動。App將會停留在這個狀態直到有其它事件取得焦點。
當發生中斷事件時，Activity就會進入Paused狀態，系統便會呼叫onPause方法。
當Activity從 Paused 狀態回到 Resumed 狀態時，系統便會呼叫 onResume 方法
onPause 代表 Activity 的暫停
當Activity失焦(變的部分可見或是透明)系統便會呼叫 onPause方法，此時Activity無法和使用者互動。在onPause中可以考慮釋放一些不需要用到的資源，但在多窗口模式中，Activity依然是完全可見的，釋放資源有可能對Activity造成影響。
若有這種狀況發生，可以考慮在onStop中再釋放資源。
onPause的執行時間很短，不一定有足夠的時間來執行操作。所以不應該在onPause方法中保存資料，進行網路操作，資料庫存取。應該在onStop中進行這些耗時操作。
當 onPause方法結束後並不代表Activity會離開Paused狀態。相反的，Activity會保持在此狀態，直到Activity再次聚焦或完全不可見。
若Activity聚焦則系統會呼叫onResume方法讓Activity回到Resumed狀態，相反的，若Activity變的完全不可見則系統就會呼叫onStop方法讓Activity進入Stopped狀態。
onStop 代表 Activity 的停止
當Activity變得完全不可見(進入後台)，系統便會叫onStop方法，Activity進入Stopped狀態。
在onStop方法中應該進行資源的調整或釋放或資料庫的儲存。
當Activity進入Stopped狀態，Activity實體保存在記憶體中，但不會連結到window manager，此時必須小心當系統的記憶體不足時將會銷毀 process。
在Activity為Stopped 狀態時，可以進入2種狀態，當Activity恢復時系統將會呼叫onRestart，若Activity結束時系統將會呼叫onDestroy。
onDestroy 代表 Activity 的銷毀
當Activity銷毀時系統將會呼叫onDestroy，呼叫的原因有2種:
1.當Actiivty結束(使用者關閉Activity或呼叫Activity的finish方法)
2.系統配置發生變化(旋轉螢幕)
在onDestroy方法中應該釋放所有不需要用到資源。
以下為Activity狀態和呼叫方法的圖示

這些狀態分別互相配對，構成 3 種生命週期，分別為完整的生命週期，可視的生命週期，前台的生命週期。
完整的生命週期包含可視的生命週期，可視的生命週期包含前台的生命週期。
完整的生命週期:
Activity 從建立到銷毀的全部過程。最外層生命週期，生命週期發生在 onCreate 到 onDestroy 之間。
可視的生命週期:
Activity 從使用者可視到離開使用者視線的過程。生命週期發生在 onStart 到 onStop 之間。注意可視包含該 Activity 被其它元件遮蓋只顯示一部分的情況。
前台的生命週期:
Activity 顯示在所有的元件之前並可與使用者互動。生命週期發生在 onResume 到 onPause 之間。
另外還有 4 種特殊的生命週期狀態，各為 onRestart, onSaveInstanceState, on RestoreInstanceState, onNewIntent。
onRestart 的呼叫點為從 onStop 到 onStart 之間，也就是 onStop -> onRestart -> onStart。
onSaveInstanceState 用於儲存 Activity 的資料。
onNewIntent 只有在 LaunchMode 為 SingleTop 且啟動的 Activity 為符合重用該 Activity 的規則時才會被呼叫。(onNewIntent -> onResume)
完整的生命週期圖如下

為了實際了解生命週期的變化，建立 FirstActivity 並覆寫所有生命週期印出 Log
FirstActivity.java

public class FirstActivity extends AppCompatActivity implements OnClickListener {
  private static final String TAG = FirstActivity.class.getSimpleName();
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Log.d(TAG, TAG + " onCreate");
    setContentView(R.layout.first_activity);
  }
  @Override
  protected void onStart() {
    super.onStart();
    Log.d(TAG, TAG + " onStart");
  }
  @Override
  protected void onResume() {
    super.onResume();
    Log.d(TAG, TAG + " onResume");
  }
  @Override
  protected void onPause() {
    super.onPause();
    Log.d(TAG, TAG + " onPause");
  }
  @Override
  protected void onStop() {
    super.onStop();
    Log.d(TAG, TAG + " onStop");
  }
  @Override
  protected void onDestroy() {
    super.onDestroy();
    Log.d(TAG, TAG + " onDestroy");
  }
  @Override
  protected void onRestart() {
    super.onRestart();
    Log.d(TAG, TAG + " onRestart");
  }
  @Override
  protected void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);
    Log.d(TAG, TAG + " onSaveInstanceState");
  }
  @Override
  protected void onRestoreInstanceState(Bundle savedInstanceState) {
    super.onRestoreInstanceState(savedInstanceState);
    Log.d(TAG, TAG + " onRestoreInstanceState");
  }
  @Override
  protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    Log.d(TAG, TAG + " onNewIntent");
  }
}

紀錄1

使用者點擊 back key, home key, menu key 所觸發的生命週期變化:

A.啟動 FirstActivity 後點擊 back key 關閉 FirstActivity
1.點擊 App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 back key:
D: FirstActivity onPause
D: FirstActivity onStop
D: FirstActivity onDestroy
B.啟動 FirstActivity 後點擊 home key
1.點擊App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 home key:
D: FirstActivity onPause
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
C.啟動 FirstActivity 後點擊 home key 再點擊 App icon
1.點擊 App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 home key:
D: FirstActivity onPause
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
3.點擊 App icon:
D: FirstActivity onRestart
D: FirstActivity onStart
D: FirstActivity onResume
D.啟動 FirstActivity 後點擊 home key 再點擊 menu key 再拖曳移除 App頁面
1.點擊 App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 home key:
D: FirstActivity onPause
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
3.點擊 menu key，拖曳移除 App:
D: FirstActivity onDestroy(注意有時候不會顯示)
E.啟動 FirstActivit y後點擊 home key 再點擊 menu key 再點擊 App 頁面
1.點擊 App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 home key:
D: FirstActivity onPause
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
3.點擊 menu key 並點擊 App 頁面:
D: FirstActivity onRestart
D: FirstActivity onStart
D: FirstActivity onResume
F.啟動 FirstActivity後點擊 menu key
1.點擊 App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 menu key:
D: FirstActivity onPause
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
G.啟動 FirstActivity 後點擊 menu key 再拖曳移除 App
1.點擊 App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 menu key:
D: FirstActivity onPause
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
3.拖曳移除 App:
沒有顯示Log , 推測應該呼叫onDestroy
H.啟動 FirstActivity 後點擊 menu key 再點擊 App頁面
1.點擊 App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 menu key:
D: FirstActivity onPause
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
3.點擊 App 頁面:
D: FirstActivity onRestart
D: FirstActivity onStart
D: FirstActivity onResume

重點:

1.按下 home key 和 menu key 都會觸發 onSaveInstanceState (在 onPause 之後)，但按下 back key 不會觸發 onSaveInstanceState。
2.當 Activity 從後台回到前台都會觸發 onRestart -> onStart -> onResume

紀錄2

Activity之間切換的生命週期變化:

2.1修改 FirstActivity，加入啟動 SecondActivity 的功能。
FirstActivity.java

public class FirstActivity extends AppCompatActivity implements OnClickListener {
…
  private Button mLaunchSecondBtn;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Log.d(TAG, TAG + " onCreate");
    setContentView(R.layout.first_activity);
    initUI();
  }
  private void initUI() {
    mLaunchSecondBtn = findViewById(R.id.first_activity_launch);
    mLaunchSecondBtn.setOnClickListener(this);
  }
  @Override
  public void onClick(View v) {
    int uiID = v.getId();
    switch (uiID) {
      case R.id.first_activity_launch_second_activity:
        Intent intent = new Intent(this, SecondActivity.class);
        startActivity(intent);
        finish();
        break;
    }
  }

2.2 新增 SecondActivity 和 FirstActivity 互相切換來觀察生命週期。
SecondActivity.java

public class SecondActivity extends AppCompatActivity implements OnClickListener {
  private static final String TAG = SecondActivity.class.getSimpleName();
  private Button mLaunchFirstBtn;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Log.d(TAG, TAG + " onCreate");
    setContentView(R.layout.second_activity);
    initUI();
  }
  @Override
  protected void onStart() {
    super.onStart();
    Log.d(TAG, TAG + " onStart");
  }
  @Override
  protected void onResume() {
    super.onResume();
    Log.d(TAG, TAG + " onResume");
  }
  @Override
  protected void onPause() {
    super.onPause();
    Log.d(TAG, TAG + " onPause");
  }
  @Override
  protected void onStop() {
    super.onStop();
    Log.d(TAG, TAG + " onStop");
  }
  @Override
  protected void onDestroy() {
    super.onDestroy();
    Log.d(TAG, TAG + " onDestroy");
  }
  @Override
  protected void onRestart() {
    super.onRestart();
    Log.d(TAG, TAG + " onRestart");
  }
  @Override
  protected void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);
    Log.d(TAG, TAG + " onSaveInstanceState");
  }
  @Override
  protected void onRestoreInstanceState(Bundle savedInstanceState) {
    super.onRestoreInstanceState(savedInstanceState);
    Log.d(TAG, TAG + " onRestoreInstanceState");
  }
  @Override
  protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    Log.d(TAG, TAG + " onNewIntent");
  }
  private void initUI() {
    mLaunchFirstBtn = findViewById(R.id.second_activity_launch_first_activity);
    mLaunchFirstBtn.setOnClickListener(this);
  }
  @Override
  public void onClick(View v) {
    int uiID = v.getId();
    switch (uiID) {
      case R.id.second_activity_launch_first_activity:
        Intent intent = new Intent(this,FirstActivity.class);
        startActivity(intent);
        finish();
        break;
    }
  }
}

A.FirstActivity 啟動 SecondActivity (FirstActivity 不會 finish)，再關閉 SecondActivity，再關閉 FirstActivity
1.點擊 App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 FirstActivity 的按鈕啟動 SecondActivity。注意 FirstActivity 沒有 finish
D: FirstActivity onPause
D: SecondActivity onCreate
D: SecondActivity onStart
D: SecondActivity onResume
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
3.點擊 back key 關閉 SecondActivity，讓 FirstActivity 回到前台
D: SecondActivity onPause
D: FirstActivity onRestart
D: FirstActivity onStart
D: FirstActivity onResume
D: SecondActivity onStop
D: SecondActivity onDestroy
4.點擊 back key 關閉 FirstActivity
D: FirstActivity onPause
D: FirstActivity onStop
D: FirstActivity onDestroy
B.FirstActivity 啟動 SecondActivity(FirstActivity 會 finish)，再關閉 SecondActivity
1.點擊 App icon 啟動 FristActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 FirstActivity 的按鈕啟動 SecondActivity。注意 FristActivity 會 finish
D: FirstActivity onPause
D: SecondActivity onCreate
D: SecondActivity onStart
D: SecondActivity onResume
D: FirstActivity onStop
D: FirstActivity onDestroy
3.按下 back key 關閉 SecondActivity
D: SecondActivity onPause
D: SecondActivity onStop
D: SecondActivity onDestroy
C.FirstActivity 啟動 SecondActivity(FirstActivity 不會 finish)， SecondActivity 再啟動 FirstActivity (SecondActivity不會finish)
1.點擊 App icon 啟動 FristActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 FirstActivity 的按鈕啟動 SecondActivity。注意 FirstActivity 不會 finish
D: FirstActivity onPause
D: SecondActivity onCreate
D: SecondActivity onStart
D: SecondActivity onResume
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
3.點擊 SecondActivity 的按鈕啟動 FirstActivity。注意 SecondActivity 不會 finish
D: SecondActivity onPause
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
D: SecondActivity onSaveInstanceState
D: SecondActivity onStop
D.FirstActivity 啟動 SecondActivity，注意 SecondActivity 使用透明主題(FirstActivity 不會 finish)， SecondActivity在啟動 FirstActivity(SecondActivity 不會 finish)
1.點擊 App icon 啟動 FristActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.點擊 FirstActivity 的按鈕啟動 SecondActivity(注意 SecondActivity 使用透明主題注意 FirstActivity不會 finish)
D: FirstActivity onPause
D: SecondActivity onCreate
D: SecondActivity onStart
D: SecondActivity onResume
D: FirstActivity onSaveInstanceState
3.點擊 SecondActivity 的按鈕啟動 FirstActivity。注意 SecondActivity 不會 finish
D: SecondActivity onPause
D: FirstActivity onStop
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
D: SecondActivity onSaveInstanceState
D: SecondActivity onStop
重點:
1.當第 1 個 Activity 啟動第 2 個 Activity時，會讓第 1 個 Activity先呼叫完 onPause，再進行第 2 個 Activity 的初始化(onCreate -> onStart -> onResume)直到第 2 個 Activity 呼叫完 onResume 之後再進行第 1 個 Activity 的後續動作。
2.當第 1 個 Activity 啟動第 2 個 Activity 時，若第 1 個 Activity 會 finish，則 onSaveInstanceState 不會被呼叫。動作順序如下
(第 1 個 Activity 啟動第 2 個 Activity)
Activity1 onPause
Activity2 onCreate
Activity2 onStart
Activity2 onResume
Activity1 onStop
Activity1 onDestroy
反之，若第 1 個Activity 不會 finish，則 onSaveInstanceState 會在 onStop 之前被呼叫。
(第 1 個 Activity 啟動第 2 個 Activity)
Activity1 onPause
Activity2 onCreate
Activity2 onStart
Activity2 onResume
Activity1 onSaveInstanceState
Activity1 onStop
3.如果要啟動的 Activity(SecondActivity)是透明主題，則啟動者(FirstActivity)啟動 SecondActivity 之後不會呼叫 onStop，如下
(當 FirstActivity 啟動 SecondActivity 之後)
D: FirstActivity onPause
D: SecondActivity onCreate
D: SecondActivity onStart
D: SecondActivity onResume
D: FirstActivity onSaveInstanceState
而當 SecondActivity 啟動 FirstActivity之後才會呼叫 onStop 如下
D: SecondActivity onPause
D: FirstActivity onStop
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
D: SecondActivity onSaveInstanceState
D: SecondActivity onStop

紀錄3.

系統配置改變所造成的生命週期變化

當系統配置發生改變，Activity 就會觸發重建過程，最常見的系統配置發生變化為旋轉螢幕。因為這種生命週期變化為系統控制，所以當觸發 onSaveInstanceState 時也會一併呼叫 onRestoreInstanceState 來恢復資料。
A.啟動 FirstActivity 後旋轉螢幕
1.點擊 App icon 啟動 FirstActivity:
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.旋轉螢幕觸發從直屏到橫屏導致 FirstActivity 重建
D: FirstActivity onPause
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
D: FirstActivity onDestroy
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onRestoreInstanceState
D: FirstActivity onResume
3.再次旋轉螢幕從橫屏到直屏導致 FristActivity 重建
D: FirstActivity onPause
D: FirstActivity onSaveInstanceState
D: FirstActivity onStop
D: FirstActivity onDestroy
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onRestoreInstanceState
D: FirstActivity onResume

重點:

1.注意旋轉螢幕之後 onSaveInstanceState 會在 onPause 之後呼叫，而 onRestoreInstanceState 會在 onStart 之後呼叫。
2.若 Activity 要恢復資料可以選擇 onCreate 或 onRestoreInstanceState，差別為於在 onCreate 中需要判斷傳入的參數 Bundle 是否為空，如果是空則不需要恢復資料，而非空才需要進行恢復資料的動作。如下

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState)
    if(savedInstanceState != null){
    // restore data
    }
}

3.若要支援旋轉螢幕，但不重建 Activity，可以在 AndroidManifest.xml 中對該 Activity 設定為

      android:configChanges="orientation|screenSize"

如此，旋轉螢幕之後 Activity 還是會切換直橫屏，但不會重建，資料也不會初始化，在這種情況下若想在旋轉螢幕時收到通知，可在 Activity 覆寫以下方法。(注意該方法只有在 android:configChanges=”orientation|screenSize” 被設定時才呼叫)。如下

  @Override
  public void onConfigurationChanged(Configuration newConfig) {
    super.onConfigurationChanged(newConfig);
    Log.d(TAG, "newConfig.toString():"+newConfig.toString());
  }

測試生命週期如下
1.點擊 App icon 啟動 FirstActivity
D: FirstActivity onCreate
D: FirstActivity onStart
D: FirstActivity onResume
2.旋轉螢幕從直屏轉為橫屏
D: newConfig.toString():{0 1.0 ?mcc?mnc zh_TW ldltr sw360dp w640dp h335dp
320dpi nrml long land finger -keyb/v/h -nav/h s.47}
3.旋轉螢幕從橫屏轉為直屏
D: newConfig.toString():{0 1.0 ?mcc?mnc zh_TW ldltr sw360dp w360dp h615dp 320dpi nrml long port finger -keyb/v/h -nav/h s.48}
4.若想保持螢幕為直屏或橫屏，可在 AndroidManifest.xml 的 Activity 加入以下

      android:screenOrientation="portrait"

螢幕便會保持直屏不會旋轉。
5.注意 onRestoreInstanceState 僅用於系統配置變化時(如旋轉螢幕)導致的重建。如果是使用者導致的重建(點擊 back key or home key)則需要在 onCreate 恢復資料。
注意以上 Activity 的生命週期實驗都是以 LaunchMode (啟動模式)為 default，在其它的啟動模式(SingleTop, SingleTask, SingleInstance)則另外需要另外紀錄。

標籤 Android

Android

OKHttp 使用注意

文章作者作者: zgh149
文章發佈日期 1 4 月, 2019

1.若想在 Callback 中修改畫面(包含產生 Dialog, Toast 等等)，必須使用 runonUiThread 包含要更改的畫面的行為，如下為使用 OKHttp 包裝器的方法宣告，

  public static void sendPostWithJSONFormat(String URL, Map<String, String> requestParameter, Callback callback) {
    MediaType JSON = MediaType.parse("application/json; charset=utf-8");
    RequestBody requestBody = RequestBody.create(JSON, new JSONObject(requestParameter).toString());
    Request request = new Request.Builder().url(URL).post(requestBody).build();
    Call call = sOKHttpClient.newCall(request);
    call.enqueue(callback);
  }

以下是使用該包裝器方法的範例

    OKHttpWrapper.sendPostWithJSONFormat(URL, httpParameter, new Callback() {
                @Override
                public void onResponse(Call call, Response response) throws IOException {
                 //更改畫面行為
                }
                @Override
                public void onFailure(Call call, IOException e) {
                 //更改畫面行為
                }
            });

重點在於第 4 行和第 9 行若有更改畫面的行為必須使用 runOnUiThread 去包含。否則會出現以下 Exception:

E/AndroidRuntime: FATAL EXCEPTION: OkHttp Dispatcher
    java.lang.RuntimeException: Can't create handler inside thread that has not called Looper.prepare()
        at android.os.Handler.<init>(Handler.java:200)
        at android.os.Handler.<init>(Handler.java:114)
        at android.app.Dialog.<init>(Dialog.java:119)
        at android.app.AlertDialog.<init>(AlertDialog.java:200)
        at android.app.AlertDialog$Builder.create(AlertDialog.java:1086)
        at okhttp3.RealCall$AsyncCall.execute(RealCall.java:153)
        at okhttp3.internal.NamedRunnable.run(NamedRunnable.java:32)
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1113)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:588)
        at java.lang.Thread.run(Thread.java:818)

Android

在裝置上產生 2 個相同的啟動圖示

文章作者作者: zgh149
文章發佈日期 7 3 月, 2019

情境:
安裝 App 後在裝置上產生 2 個該 App 的啟動圖示

原因:
通常是在 AndroidManifest.xml 中的 Activity，同時存在 2 個如下的 intent-filter 內容

      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>

如下面的 SplashActivity 和 MainActivity 都有相同的 intent-filter

...
<application
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="2 launcher icon"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/AppTheme">
    <activity android:name=".splash.SplashActivity">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>
    <activity android:name=".MainActivity">
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>
  </application>

解法:
移除其中一個相同的 intent-filter

Android

Android Studio 在專案中引用 AAR

文章作者作者: zgh149
文章發佈日期 6 3 月, 2019

使用 Android Studio 並在專案中引用 AAR，需要 2 個步驟
1.把要使用的 AAR 檔拷貝到 app/libs 目錄，完成後如下圖
2.右鍵點擊專案 -> Open Module Settings
2-1.選擇左方的 Modules 的 app -> 點擊左上方的 + 號，如下圖

2-2. 在 Create New Module 視窗選擇 Import .JAR/.AAR Package -> 點擊 next

2-3.在 import Module from Library 視窗的 File Name: 選擇第1步驟的 AAR 檔案位置 -> 點擊 OK -> Subproject name: 不必修改 -> 點擊 Finish -> Gradle 會自動更新，更新完成後點擊 OK
2-4.右鍵點擊專案 -> Open Module Settings -> 左方 Modules 選擇 app -> 點擊右上方 Dependencies -> 點擊最右上方的 + 號 -> 選擇 3 Module dependency

2-5.在 Choose Modules 視窗選擇 CommonTool-debug -> 點擊 OK -> 在 Project Structure 視窗點擊 OK -> 完成

Android

在 Activity 中判斷滑動手勢

文章作者作者: zgh149
文章發佈日期 5 3 月, 2019

在 Activity 判斷滑動手勢主要是透過 View.OnTouchListener 和 GestureDetector.OnGestureListener
透過讓 Activity 繼承 GestureDetector.OnGestureListener 並實作其中的 onFling 方法，在 onFling 方法中判斷第 1 個按下點的 X 座標和第 2 個按下點的 X 座標是否超過標準值來決定是否為滑動手勢。

import android.support.constraint.ConstraintLayout;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.GestureDetector;
import android.view.MotionEvent;
import android.view.View;
public class FlingGestureExampleMainActivity extends AppCompatActivity implements View.OnTouchListener,
    GestureDetector.OnGestureListener{
  private static final String TAG = FlingGestureExampleMainActivity.class.getSimpleName();
  //main ui
  private LinearLayout mBasicLayout;
  private GestureDetector mGesetureDetector;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.fling_gesture_example_main_activity);
    mBasicLayout = findViewById(R.id.basic_layout_activity);
    mBasicLayout.setOnTouchListener(this);
    mBasicLayout.setLongClickable(true);
    mGesetureDetector = new GestureDetector((GestureDetector.OnGestureListener) this);
  }
  @Override
  public boolean onDown(MotionEvent e) {
    return false;
  }
  @Override
  public void onShowPress(MotionEvent e) {
  }
  @Override
  public boolean onSingleTapUp(MotionEvent e) {
    return false;
  }
  @Override
  public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
    return false;
  }
  @Override
  public void onLongPress(MotionEvent e) {
  }
  @Override
  public boolean onFling(MotionEvent firstMotion, MotionEvent secondMotion, float velocityX, float velocityY) {
    final int FLING_MIN_DISTANCE = 100;
    final int FLING_MIN_VELOCITY = 200;
    boolean isFlingToLeft = firstMotion.getX() - secondMotion.getX() > FLING_MIN_DISTANCE && Math.abs(velocityX) > FLING_MIN_VELOCITY;
    if (isFlingToLeft) {
      Log.d(TAG, "to left");
    }
    boolean isFlingToRight = firstMotion.getX() - secondMotion.getX() < FLING_MIN_DISTANCE && Math.abs(velocityX) < FLING_MIN_VELOCITY;
    if (isFlingToRight) {
      Log.d(TAG, "to right");
    }
    return false;
  }
  @Override
  public boolean onTouch(View view, MotionEvent motionEvent) {
    return mGesetureDetector.onTouchEvent(motionEvent);
  }
}

主要的重點為讓 Activity實作 onDown, onShowPress, on SingleTapUp, onScroll, onLongPress, onFling, onTouch 方法，
並在 onFling 方法判斷滑動的邏輯。
以及第23~26行的手勢和 layout 物件的連結
layout檔(fling_gesture_example_main_activity.xml)

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
  xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  xmlns:tools="http://schemas.android.com/tools"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:id="@+id/basic_layout_activity"
  tools:context=".FlingGestureExampleMainActivity">
  <ListView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    .../>
</LinearLayout>

重點為 LinearLayout 建立 id，以便在程式碼中參考。
以上便是讓 Activity 加入滑動手勢的判斷，若是想讓該 Activity中
的 ListView 也可偵測滑動，作法相當簡單，直接讓該 ListView 呼叫 setOnTouchListener 和 setLongClickable 即可。

        mListView = getListView();
        mListViewAdapter = new ListViewAdapter();
        setListAdapter(mListViewAdapter);
        ...
        mPatrolPointListView.setOnTouchListener(this);
        mPatrolPointListView.setLongClickable(true);

Android Uncategorized

android.util.Log 列印訊息內容太多無法完全顯示

文章作者作者: zgh149
文章發佈日期 4 3 月, 2019

使用 android.util.Log 列印訊息時，若訊息內容太多就會出現無法完全顯示訊息內容的情況。
解決的方法就是分段列印，如下

    private void logLongMessage(String TAG, String message) {
        int maxMessageSize = 2000;
        for (int i = 0; i <= message.length() / maxMessageSize; i++) {
            int start = i * maxMessageSize;
            int end = (i + 1) * maxMessageSize;
            end = end > message.length() ? message.length() : end;
            Log.d(TAG, message.substring(start, end));
        }
    }

標籤 Android

Android Uncategorized

使用 Room DAO 存取資料 (Room)

要使用 Room 存取資料，需要使用 DAO。
這組 DAO 物件形成了 Room 的主要組件，因為每個 DAO 都包含提供對資料庫的抽象訪問方法。
通過使用 DAO 類別而不是查詢構建器或直接查詢來訪問資料庫，使用者可以分離出資料庫架構的不同元件。
此外，DAO 可在測試應用程序時輕鬆模擬資料庫訪問。
注意:
在加入 DAO 類別之前，先在 app 的 build.gradle 加入相依性。
DAO 可以是 interface，也可以是抽象類別。如果是抽象類別，它可以選擇有一個構造函數，它將 RoomDatabase 作為唯一的參數。Room 在編譯時期建立每個 DAO 實作。
注意:
Room 並不支援在 Main thread 上存取資料庫，因為可能會長時間鎖定 UI。
如果要讓 Room 支援在其他執行緒存取資料庫則必須在建構時呼叫allowMainThreadQueries() 方法。
異步查詢 – 若是查詢會返回 LiveData 或 Flowable 實例 – 不受此規則的約束，因為它們在需要時在後台線程上異步運行查詢

Define methods for convenience

可以使用 DAO 類別表示多個便捷查詢。

Insert

當建立 DAO 方法並使用 @Insert 註釋時，Room 會生成一個實現，該實現在單一事務(single transaction)中將所有參數插入到資料庫中。

@Dao
public interface MyDao {
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    public void insertUsers(User... users);
    @Insert
    public void insertBothUsers(User user1, User user2);
    @Insert
    public void insertUsersAndFriends(User user, List<User> friends);
}

如果 @Insert 方法只接收 1 個參數，則它可以返回 long，這是該插入項目的新 rowId。如果參數是陣列或集合，則應返回 long [] 或 List <Long>。
有關更多詳細信息，請參閱 @Insert 的文件，以及 SQLite documenation for rowid tables。

Update

Update 修改資料庫中作為參數給出的一組實體。它使用每個實體的主鍵做查詢。

@Dao
public interface MyDao {
    @Update
    public void updateUsers(User... users);
}

雖然通常沒有必要，但可以讓此方法返回一個 int 值，表示資料庫中更新的行數。

Delete

Delete 從資料庫中刪除一組從參數傳入的實體。使用主鍵來查找要刪除的實體。

@Dao
public interface MyDao {
    @Delete
    public void deleteUsers(User... users);
}

雖然通常沒有必要，但可以讓此方法返回一個 int 值，表示從資料庫中刪除的行數。

Query for information

@Query 是 DAO 類別中使用的主要註釋。它可以對資料庫執行讀/寫操作。
每個 @Query 方法都在編譯時進行驗證，因此如果查詢出現問題，則會發生編譯錯誤而不是運行時失敗。
Room 也會驗證查詢的返回值，避免返回的物件中的屬性名稱與查詢的相應列名稱不相符，Room 使用以下兩個方法之一

如果只有一些屬性名稱相符，它會發出警告。
如果沒有屬性名稱相符，則會發出錯誤。

Simple queries

@Dao
public interface MyDao {
    @Query("SELECT * FROM user")
    public User[] loadAllUsers();
}

以上是一個非常簡單的查詢，可以取得所有用戶。在編譯時，Room 知道正在查詢用戶表中的所有列。如果查詢包含語法錯誤，或者資料庫中不存在該資料表，則在應用程序編譯時，Room 會顯示包含相應消息的錯誤。

Passing parameters into the query

大多數情況下，需要將參數傳遞給查詢以執行過濾操作，例如僅顯示年齡超過特定年齡的用戶。
要傳入參數，請在 Room 註釋中使用方法參數，如以下代碼段所示

@Dao
public interface MyDao {
    @Query("SELECT * FROM user WHERE age > :minAge")
    public User[] loadAllUsersOlderThan(int minAge);
}

在編譯時處理此查詢時，Room 會將:minAge 綁定參數與 minAge 方法的參數。
Room 使用參數名稱檢查是否相符。如果存在不相符，則在應用編譯時會發生錯誤。
還可以在查詢中多次傳遞多個參數或引用它們，如以下代碼段所示：

@Dao
public interface MyDao {
    @Query("SELECT * FROM user WHERE age BETWEEN :minAge AND :maxAge")
    public User[] loadAllUsersBetweenAges(int minAge, int maxAge);
    @Query("SELECT * FROM user WHERE first_name LIKE :search " +
           "OR last_name LIKE :search")
    public List<User> findUserWithName(String search);
}

Returning subsets of columns

大多數情況下，只需要獲得實體的幾個屬性。
例如，UI 可能只顯示用戶的名字和姓氏，而不是用戶的每一個訊息。
通過僅提取 UI 顯示的列，可以節省寶貴的資源，並且讓查詢可以更快地完成。
Room 允許從查詢中返回任何基於 Java 的對象，只要結果可以映射到返回的對象即可。
例如，可以建立以下（POJO）來獲取用戶的名字和姓氏

public class NameTuple {
    @ColumnInfo(name = "first_name")
    public String firstName;
    @ColumnInfo(name = "last_name")
    public String lastName;
}

現在，可以在查詢方法中使用此 POJO：

@Dao
public interface MyDao {
    @Query("SELECT first_name, last_name FROM user")
    public List<NameTuple> loadFullName();
}

Room 了解查詢返回 first_name 和 last_name 列的值，並且這些值可以映射到 NameTuple 類別的屬性中。因此，Room 可以生成正確的代碼。
如果查詢返回太多列，或者有 NameTuple 類別中不存在的列，則 Room 會顯示警告。
注意:
這些 POJO 也可以使用 @Embedded 註釋。

Passing a collection of arguments

某些查詢可能要求傳入可變數量的參數，並且在運行時之前不知道參數的確切數量。
例如，可能希望從區域子集中檢索有關所有用戶的信息。
Room 了解參數何時表示集合，並根據提供的參數數量在運行時自動擴展它。

@Dao
public interface MyDao {
    @Query("SELECT first_name, last_name FROM user WHERE region IN (:regions)")
    public List<NameTuple> loadUsersFromRegions(List<String> regions);
}

Observable queries

執行查詢時，通常希望應用程序的UI在資料更改時自動更新。
要實現此目的，請在查詢方法描述中使用 LiveData 類型的返回值。
Room 會產生所有必要的代碼，以便在更新資料庫時更新 LiveData。

@Dao
public interface MyDao {
    @Query("SELECT first_name, last_name FROM user WHERE region IN (:regions)")
    public LiveData<List<User>> loadUsersFromRegionsSync(List<String> regions);
}

注意:
從版本 1.0 開始，Room 使用查詢中訪問的表列表來決定是否更新 LiveData 的實例。

Reactive queries with RxJava

Room 為 RxJava2 類型的返回值提供以下支持：

@Query methods: Room supports return values of type Publisher, Flowable, and Observable
@Insert, @Update, and @Delete methods: Room 2.1.0 and higher supports return values of type Completable, Single<T>, and Maybe<T>

要使用此功能，請在 app 的 build.gradle 文件中包含最新版本的 rxjava2：

dependencies {
    implementation 'androidx.room:room-rxjava2:2.1.0-alpha02'
}

以下代碼示範如何使用這些返回類型：

@Dao
public interface MyDao {
    @Query("SELECT * from user where id = :id LIMIT 1")
    public Flowable<User> loadUserById(int id);
    // Emits the number of users added to the database.
    @Insert
    public Maybe<Integer> insertLargeNumberOfUsers(List<User> users);
    // Makes sure that the operation finishes successfully.
    @Insert
    public Completable insertLargeNumberOfUsers(User... users);
    /* Emits the number of users removed from the database. Always emits at
       least one user. */
    @Delete
    public Single<Integer> deleteUsers(List<User> users);
}

有關更多詳細信息，請參閱 Google Developers Room and RxJava。

Direct cursor access

如果需要直接存取返回的行，則可以從查詢中返回 Cursor 物件，如以下代碼段所示：

@Dao
public interface MyDao {
    @Query("SELECT * FROM user WHERE age > :minAge LIMIT 5")
    public Cursor loadRawUsersOlderThan(int minAge);
}

警告:
非常不建議使用 Cursor API，因為它不能保證行是否存在或行包含的值。

Query multiple tables

某些查詢可能需要訪問多個表來計算結果。Room 允許編寫任何查詢，因此也可以查詢多個資料表。
此外，如果響應是可觀察的數據類型（如 Flowable 或 LiveData），則會監視查詢中引用的所有資料表以檢查是否無效。
以下代碼段顯示如何查詢不同的資料表：

@Dao
public interface MyDao {
    @Query("SELECT * FROM book " +
           "INNER JOIN loan ON loan.book_id = book.id " +
           "INNER JOIN user ON user.id = loan.user_id " +
           "WHERE user.name LIKE :userName")
   public List<Book> findBooksBorrowedByNameSync(String userName);
}

還可以從這些查詢中返回 POJO。

@Dao
public interface MyDao {
   @Query("SELECT user.name AS userName, pet.name AS petName " +
          "FROM user, pet " +
          "WHERE user.id = pet.user_id")
   public LiveData<List<UserPet>> loadUserAndPetNames();
   // You can also define this class in a separate file, as long as you add the
   // "public" access modifier.
   static class UserPet {
       public String userName;
       public String petName;
   }
}

標籤 Android

Android Uncategorized

在資料庫中建立 View (Room)

Room 2.1.0 及更高版本提供對 SQLite 資料庫的 View 功能，允許使用者將查詢封裝到類別中。Room 將這些查詢支持的類別稱為 View，作用和使用 DAO 的簡單資料物件相同。
注意:
與實體(Entitiy)一樣，可以針對 View 運行 SELECT 語句。但是無法對 View 進行 INSERT， UPDATE 或 DELETE 語句。

Create a view

要建立 View，請將 @DatabaseView 註釋加入類別。將註釋的值設置為該類別應表示的查詢。以下代碼段提供了一個 View 範例：

@DatabaseView("SELECT user.id, user.name, user.departmentId," +
              "department.name AS departmentName FROM user " +
              "INNER JOIN department ON user.departmentId = department.id")
public class UserDetail {
    public long id;
    public String name;
    public long departmentId;
    public String departmentName;
}

Associate a view with your database

要將該 View 作為資料庫的一部分，請在 @Database 註釋中加入 views 屬性

@Database(entities = {User.class}, views = {UserDetail.class},
          version = 1)
public abstract class AppDatabase extends RoomDatabase {
    public abstract UserDao userDao();
}

標籤 Android