DialogFragment源碼分析

時間 2020-01-24

標籤 dialogfragment 源碼分析简体版

原文原文鏈接

目錄介紹

1.最簡單的使用方法
- 1.1 官方建議
- 1.2 最簡單的使用方法
- 1.3 DialogFragment作屏幕適配
2.源碼分析
- 2.1 DialogFragment繼承Fragment
- 2.2 onCreate(@Nullable Bundle savedInstanceState)源碼分析
- 2.3 setStyle(@DialogStyle int style, @StyleRes int theme)
- 2.4 onActivityCreated(Bundle savedInstanceState)源碼分析
- 2.5 onCreateDialog(Bundle savedInstanceState)源碼分析
- 2.6 重點分析彈窗展現和銷燬源碼
3.經典總結
4.DialogFragment封裝庫介紹
5.常見問題總結
- 5.1 使用中show()方法遇到的IllegalStateException

好消息

博客筆記大彙總【16年3月到至今】，包括Java基礎及深刻知識點，Android技術博客，Python學習筆記等等，還包括平時開發中遇到的bug彙總，固然也在工做之餘收集了大量的面試題，長期更新維護而且修正，持續完善……開源的文件是markdown格式的！同時也開源了生活博客，從12年起，積累共計47篇[近20萬字]，轉載請註明出處，謝謝！
連接地址：https://github.com/yangchong211/YCBlogs
若是以爲好，能夠star一下，謝謝！固然也歡迎提出建議，萬事起於忽微，量變引發質變！
DialogFragment封裝庫項目地址：https://github.com/yangchong211/YCDialog
02.Toast源碼深度分析
- 最簡單的建立，簡單改造避免重複建立，show()方法源碼分析，scheduleTimeoutLocked吐司如何自動銷燬的，TN類中的消息機制是如何執行的，普通應用的Toast顯示數量是有限制的，用代碼解釋爲什麼Activity銷燬後Toast仍會顯示，Toast偶爾報錯Unable to add window是如何產生的，Toast運行在子線程問題，Toast如何添加系統窗口的權限等等
03.DialogFragment源碼分析
- 最簡單的使用方法，onCreate(@Nullable Bundle savedInstanceState)源碼分析，重點分析彈窗展現和銷燬源碼，使用中show()方法遇到的IllegalStateException分析
05.PopupWindow源碼分析
- 顯示PopupWindow，注意問題寬和高屬性，showAsDropDown()源碼，dismiss()源碼分析，PopupWindow和Dialog有什麼區別？爲什麼彈窗點擊一下就dismiss呢？
06.Snackbar源碼分析
- 最簡單的建立，Snackbar的make方法源碼分析，Snackbar的show顯示與點擊消失源碼分析，顯示和隱藏中動畫源碼分析，Snackbar的設計思路，爲何Snackbar老是顯示在最下面
07.彈窗常見問題
- DialogFragment使用中show()方法遇到的IllegalStateException,什麼常見產生的？Toast偶爾報錯Unable to add window，Toast運行在子線程致使崩潰如何解決？

1.最簡單的使用方法

1.1 官方建議

Android比較推薦採用DialogFragment實現對話框，它徹底可以實現Dialog的全部需求，而且還能複用Fragment的生命週期管理，被後臺殺死後，能夠恢復重建。
在手機配置變化致使 Activity 須要從新建立時，例如旋轉屏幕，基於 DialogFragment 的對話框將會由 FragmentManager 自動重建，然而基於 Dialog 實現的對話框卻沒有這樣的能力

1.2 最簡單的使用方法

以下所示：php

public class CustomDialogFragment extends DialogFragment {

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //設置樣式
        setStyle(DialogFragment.STYLE_NO_TITLE, R.style.CenterDialog);
    }

    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container,
                             @Nullable Bundle savedInstanceState) {
        return inflater.inflate(R.layout.view_fragment_dialog, container, false);
    }

    public static void showDialog(FragmentActivity activity){
        CustomDialogFragment customDialogFragment = new CustomDialogFragment();
        customDialogFragment.show(activity.getSupportFragmentManager(),"yc");
    }
}

//而後一行代碼調用
CustomDialogFragment.showDialog(this);

1.2.1 建立theme主題樣式，而且進行設置
- 設置樣式，以DialogFragment爲例，只須要在onCreate中setStyle(DialogFragment.STYLE_NO_TITLE, R.style.CenterDialog)便可。
- 注意，CenterDialog中能夠設置彈窗的動畫效果。
- 注意一下style常量，這裏只是展現經常使用的。
```
STYLE_NORMAL：會顯示一個普通的dialog
STYLE_NO_TITLE：不帶標題的dialog
STYLE_NO_FRAME：無框的dialog
STYLE_NO_INPUT：沒法輸入內容的dialog，即不接收輸入的焦點，並且觸摸無效。
```
1.2.2 重寫onCreateView方法建立彈窗
1.2.3 建立類的對象，而後調用show(FragmentManager manager, String tag)方法便可建立出彈窗

1.2.4 如何去掉標題欄，也許你會問，爲何第二種要在super.onActivityCreated(savedInstanceState)以前設置呢。這個是由於，看了源碼以後才知道onActivityCreated這個方法中，有mDialog.setContentView(view)這一步，說到setContentView是否是很熟悉。沒錯，後面再深度解析這塊源碼思路……java

//第一種
//設置樣式時，使用STYLE_NO_TITLE
setStyle(DialogFragment.STYLE_NO_TITLE, R.style.CenterDialog);

//第二種
@Override
public void onActivityCreated(Bundle savedInstanceState) {
    Window window = getDialog().getWindow();
    if(window!=null){
        window.requestFeature(Window.FEATURE_NO_TITLE);
    }
    super.onActivityCreated(savedInstanceState);
}

2.源碼分析

2.1 DialogFragment繼承Fragment

DialogFragment是繼承Fragment，具備Fragment的生命週期，本質上說就是Fragment，只是其內部還有一個dialog而已。你既能夠當它是Dialog使用，也能夠把它做爲Fragment使用。

2.2 onCreate(@Nullable Bundle savedInstanceState)源碼分析

onCreate這個方法主要是保存一些屬性狀態，好比style樣式，theme注意，是否能夠取消，後退棧的ID等等。android

重點看一下mShowsDialog這個參數，這個參數是Boolean值，mShowsDialog = mContainerId == 0;因此，默認狀況下，mContainerId就是0，因此mShowsDialog就是true；而當你在把它當成Fragment使用時，會爲其指定xml佈局中位置，那麼mContainerId也會不爲0，因此mShowsDialog就是false。git

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);

mShowsDialog = mContainerId == 0;

if (savedInstanceState != null) {
    mStyle = savedInstanceState.getInt(SAVED_STYLE, STYLE_NORMAL);
    mTheme = savedInstanceState.getInt(SAVED_THEME, 0);
    mCancelable = savedInstanceState.getBoolean(SAVED_CANCELABLE, true);
    mShowsDialog = savedInstanceState.getBoolean(SAVED_SHOWS_DIALOG, mShowsDialog);
    mBackStackId = savedInstanceState.getInt(SAVED_BACK_STACK_ID, -1);
}
}

mShowsDialog這個參數的做用
- 而後直接搜索，能夠看到這個參數，能夠看到mShowsDialog是false，若是不是Dialog，則調用Fragment自身的方法；不然，就先建立一個dialog，而後，根據以前設置的style，經過setupDialog(mDialog, mStyle)，對dialog賦值。因此，setStyle這個方法調用，必定要在onCreateView以前。通常來說，都會放到onCreate中調用。

2.3 setStyle(@DialogStyle int style, @StyleRes int theme)源碼分析

這個方法很重要呢，注意是設置對話框的基本外觀和設置主題等等。經過手動設置Dialog和Window能夠實現相同的效果，若是是在對話框建立以後調用它將會失去做用……
- 經過這個方法，能夠看到，在不設置theme，即爲0的狀況下，theme會被設置爲android.R.style.Theme_Panel。
```
public void setStyle(@DialogStyle int style, @StyleRes int theme) {
mStyle = style;
if (mStyle == STYLE_NO_FRAME || mStyle == STYLE_NO_INPUT) {
    mTheme = android.R.style.Theme_Panel;
}
if (theme != 0) {
    mTheme = theme;
}
}
```

2.4 onActivityCreated(Bundle savedInstanceState)源碼分析

該方法的做用主要是：當DialogFragment依附的Activity被建立的時候調用,此時fragment的活動窗體被初始化
- 能夠看到這個方法，若是是彈窗已經show出來的話，則直接return。而後經過setContentView方法將view建立出來。同時還設置了彈窗是否能夠被取消，以及點擊事件等等。

2.5 onCreateDialog(Bundle savedInstanceState)源碼分析

onCreateDialog方法，你能夠重寫這個方法，建立一個本身定義好的dialog。默認狀況下，會本身建立一個Dialog。
```
@NonNull
public Dialog onCreateDialog(Bundle savedInstanceState) {
    return new Dialog(getActivity(), getTheme());
}
```

2.6 重點分析彈窗展現和銷燬源碼

2.6.1 show方法

第一種：顯示對話框，將片斷添加到給定的FragmentManager中。這對於顯式建立事務、使用給定的標記將片斷添加到事務並提交它是很方便的。這樣作能夠將事務添加到後臺堆棧。當片斷被取消時，將執行一個新的事務來從活動中刪除它。
第二種：顯示對話框，使用現有事務添加片斷，而後提交事務。
共同點：這兩種顯示方式都是經過tag的方式將DialogFragment以事務的形式提交,不一樣的是第二種方式是採用已經建立過的transaction,而且他返回了一個int類型的數值mBackStackId,mBackStackId是幹什麼用的呢?github
- mBackStackId:是作爲將DialogFragment壓入回退棧的編號,初始值是-1,若是DialogFragment是用第二種方式show的話,他將被transaction默認壓入回退棧,mBackStackId=transaction.commit(),此時她的回退棧編號大於0,她的具體使用在dismissInternal方法中後面會具體介紹
```
public void show(FragmentManager manager, String tag) {
mDismissed = false;
mShownByMe = true;
FragmentTransaction ft = manager.beginTransaction();
ft.add(this, tag);
ft.commit();
}
```
public int show(FragmentTransaction transaction, String tag) {
mDismissed = false;
mShownByMe = true;
transaction.add(this, tag);
mViewDestroyed = false;
mBackStackId = transaction.commit();
return mBackStackId;
}面試

2.6.2 dismiss()銷燬方法

在源碼中能夠看到這兩個方法都調用了dismissInternal(boolean)方法,不一樣的是傳入的boolean值一個爲false一個爲true,那麼究竟這個boolean起到什麼做用呢？
- 在dismissInternal這個方法中，主要操做了：若是對話框已經不可見就跳出方法體；設置對話框消失，而後將對話框屬性設置不可見；若是DialogFragment中的Dialog對象不爲空,就讓其內的對話框消失；而後銷燬View；對於回退棧編號mBackStackId,在前面show方法源碼分析時提到這個呢！主要是用show(FragmentTransaction transaction, String tag)這個方法來壓棧的,因此要取消對話框須要在這裏面判斷,已壓棧的要彈出回退棧,這個回退棧是由Activity來管理的,若是show(FragmentManager manager, String tag)方式的話則不須要彈棧,只須要在FragmentTransaction中將其remove掉便可。
- 簡單總結就是：調用dialog的dismiss方法後，若是本身在後退棧中，就將本身從後退棧中移除掉；若是本身不在後退棧中，就將本身從FragmentManager中移除掉。

2.6.3 dialog顯示與隱藏

具體看下面代碼編程
- 在OnStart的時候，將dialog進行show出來；在生命週期方法onStop()時，則是將其先隱藏；最後在onDestroyView方法，它會將dialog銷燬並置null。
```
@Override
public void onStart() {
super.onStart();
if (mDialog != null) {
    mViewDestroyed = false;
    mDialog.show();
}
}
```
@Override
public void onStop() {
super.onStop();
if (mDialog != null) {
mDialog.hide();
}
}segmentfault

@Override
public void onDestroyView() {
super.onDestroyView();
if (mDialog != null) {
// Set removed here because this dismissal is just to hide
// the dialog -- we don't want this to cause the fragment to
// actually be removed.
mViewDestroyed = true;
mDialog.dismiss();
mDialog = null;
}
}markdown

3.經典總結

DialogFragment是繼承Fragment，具備Fragment的生命週期，本質上說就是Fragment，只是其內部還有一個dialog而已。你既能夠當它是Dialog使用，也能夠把它做爲Fragment使用。
onCreateView能夠加載客戶化更高的對話框，onCreateDialog加載系統AlertDialog類型對話框比較合適。
DialogFragmnet對話框橫屏時對話框不會關閉，由於DailogFragment有Fragment屬性，會在屏幕發生變化時從新建立DialogFragment。
setStyle的調用點，要放在onCreateView前，通常是放在onCreat方法中執行，不然，設置的style和theme將不起做用！setStyle中，style的參數是不能夠相互一塊兒使用的，只能用一個，若是還不知足你使用，能夠經過設置theme來知足。

4.DialogFragment封裝庫介紹

項目地址：https://github.com/yangchong211/YCDialog

自定義對話框，其中包括：自定義Toast，採用builder模式，支持設置吐司多個屬性；自定義dialog控件，仿IOS底部彈窗；自定義DialogFragment彈窗，支持自定義佈局，也支持填充recyclerView佈局；自定義PopupWindow彈窗，輕量級，還有自定義Snackbar等等；還有自定義loading加載窗，簡單便用。這裏只是展現dialogFragment用法！

第一種：鏈式編程，以下所示app

BottomDialogFragment.create(getSupportFragmentManager())
    .setViewListener(new BottomDialogFragment.ViewListener() {
        @Override
        public void bindView(View v) {

        }
    })
    .setLayoutRes(R.layout.dialog_bottom_layout_list)
    .setDimAmount(0.5f)
    .setTag("BottomDialog")
    .setCancelOutside(true)
    .setHeight(getScreenHeight() / 2)
    .show();

第二種：直接繼承，能夠高度定製本身想要的彈窗

public class ADialog extends BaseDialogFragment {
    @Override
    protected boolean isCancel() {
        return false;
    }

    @Override
    public int getLayoutRes() {
        return 0;
    }

    @Override
    public void bindView(View v) {

    }
}

5.常見問題總結

5.1 使用中show()方法遇到的IllegalStateException

報錯日誌以下：

lang.IllegalStateException: Can not perform this action after onSaveInstanceState at android.support.v4.app.FragmentManagerImpl.checkStateLoss(FragmentManager.java:1493)

出現該問題的緣由
- Activity 調用了onSaveInstanceState（）之後有觸發了dialog的顯示，dialog.show（）方法裏邊用的是commit（）而不是commitAllowingStateLoss（）
追蹤報錯日誌的來源
- 因而，我挺好奇，show方法中只有兩個參數，決定從getSupportFragmentManager()方法分析.FragmentManager是抽象類，我這裏主要是看FragmentManagerImpl實現類代碼
```
//第一步：
public FragmentManager getSupportFragmentManager() {
return mFragments.getSupportFragmentManager();
}
```
//第二步:
public FragmentManager getSupportFragmentManager() {
return mHost.getFragmentManagerImpl();
}

//第三步：
FragmentManagerImpl getFragmentManagerImpl() {
return mFragmentManager;
}

//第四步：看beginTransaction()方法br/>@Override
public FragmentTransaction beginTransaction() {
return new BackStackRecord(this);
}

//第五步：看BackStackRecord類中看commit方法br/>@Override
public int commit() {
return commitInternal(false);
}

@Override
public int commitAllowingStateLoss() {
return commitInternal(true);
}

//第六步：能夠看到這倆函數的區別就是commitInternal()方法中參數一個爲true，一個爲false
int commitInternal(boolean allowStateLoss) {
if (mCommitted) throw new IllegalStateException("commit already called");
if (FragmentManagerImpl.DEBUG) {
Log.v(TAG, "Commit: " + this);
LogWriter logw = new LogWriter(TAG);
PrintWriter pw = new PrintWriter(logw);
dump(" ", null, pw, null);
pw.close();
}
mCommitted = true;
if (mAddToBackStack) {
mIndex = mManager.allocBackStackIndex(this);
} else {
mIndex = -1;
}
mManager.enqueueAction(this, allowStateLoss);
return mIndex;
}

//第七步：再追蹤到enqueueAction(this,allowStateLoss)
public void enqueueAction(OpGenerator action, boolean allowStateLoss) {
if (!allowStateLoss) {
checkStateLoss();
}
synchronized (this) {
if (mDestroyed || mHost == null) {
throw new IllegalStateException("Activity has been destroyed");
}
if (mPendingActions == null) {
mPendingActions = new ArrayList<>();
}
mPendingActions.add(action);
scheduleCommit();
}
}

//第八步：checkStateLoss()方法，這裏能夠看到拋出的錯誤日誌呢
private void checkStateLoss() {
if (mStateSaved) {
throw new IllegalStateException(
"Can not perform this action after onSaveInstanceState");
}
if (mNoTransactionsBecause != null) {
throw new IllegalStateException(
"Can not perform this action inside of " + mNoTransactionsBecause);
}
}