DialogFragment源码分析

ゞ浴缸里的玫瑰 2021-10-01 01:38 161阅读 0赞

#### 目录介绍 ####

*  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][https_github.com_yangchong211_YCBlogs]**
 *  如果觉得好，可以star一下，谢谢！当然也欢迎提出建议，万事起于忽微，量变引起质变！
 *  DialogFragment封装库项目地址：[https://github.com/yangchong211/YCDialog][https_github.com_yangchong211_YCDialog]
 *  [02.Toast源码深度分析][02.Toast]
    
     *  最简单的创建，简单改造避免重复创建，show()方法源码分析，scheduleTimeoutLocked吐司如何自动销毁的，TN类中的消息机制是如何执行的，普通应用的Toast显示数量是有限制的，用代码解释为何Activity销毁后Toast仍会显示，Toast偶尔报错Unable to add window是如何产生的，Toast运行在子线程问题，Toast如何添加系统窗口的权限等等
 *  [03.DialogFragment源码分析][03.DialogFragment]
    
     *  最简单的使用方法，onCreate(@Nullable Bundle savedInstanceState)源码分析，重点分析弹窗展示和销毁源码，使用中show()方法遇到的IllegalStateException分析
 *  [05.PopupWindow源码分析][05.PopupWindow]
    
     *  显示PopupWindow，注意问题宽和高属性，showAsDropDown()源码，dismiss()源码分析，PopupWindow和Dialog有什么区别？为何弹窗点击一下就dismiss呢？
 *  [06.Snackbar源码分析][06.Snackbar]
    
     *  最简单的创建，Snackbar的make方法源码分析，Snackbar的show显示与点击消失源码分析，显示和隐藏中动画源码分析，Snackbar的设计思路，为什么Snackbar总是显示在最下面
 *  [07.弹窗常见问题][07.]
    
     *  DialogFragment使用中show()方法遇到的IllegalStateException,什么常见产生的？Toast偶尔报错Unable to add window，Toast运行在子线程导致崩溃如何解决？

### 1.最简单的使用方法 ###

#### 1.1 官方建议 ####

*  Android比较推荐采用DialogFragment实现对话框，它完全能够实现Dialog的所有需求，并且还能复用Fragment的生命周期管理，被后台杀死后，可以恢复重建。
 *  在手机配置变化导致 Activity 需要重新创建时，例如旋转屏幕，基于 DialogFragment 的对话框将会由 FragmentManager 自动重建，然而基于 Dialog 实现的对话框却没有这样的能力

#### 1.2 最简单的使用方法 ####

*  如下所示：
    
        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是不是很熟悉。没错，后面再深度解析这块源码思路……
    
        //第一种 //设置样式时，使用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等等。
    
     *  重点看一下mShowsDialog这个参数，这个参数是Boolean值，mShowsDialog = mContainerId == 0;所以，默认情况下，mContainerId就是0，所以mShowsDialog就是true；而当你在把它当成Fragment使用时，会为其指定xml布局中位置，那么mContainerId也会不为0，所以mShowsDialog就是false。
    
        @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中调用。
     *  ![image][]

#### 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创建出来。同时还设置了弹窗是否可以被取消，以及点击事件等等。
     *  ![image][image 1]

#### 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是干什么用的呢?
    
     *  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中移除掉。
     *  ![image][image 2]
     *  ![image][image 3]

##### 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(); } } @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; } }

### 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][https_github.com_yangchong211_YCDialog] ####

*  自定义对话框，其中包括：自定义Toast，采用builder模式，支持设置吐司多个属性；自定义dialog控件，仿IOS底部弹窗；自定义DialogFragment弹窗，支持自定义布局，也支持填充recyclerView布局；自定义PopupWindow弹窗，轻量级，还有自定义Snackbar等等；还有自定义loading加载窗，简单便用。这里只是展示dialogFragment用法！
 *  第一种：链式编程，如下所示
    
        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()方法 @Override public FragmentTransaction beginTransaction() { return new BackStackRecord(this); } //第五步：看BackStackRecord类中看commit方法 @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); } }

### 关于其他内容介绍 ###

#### 01.关于博客汇总链接 ####

*  1.[技术博客汇总][Link 1]
 *  2.[开源项目汇总][Link 2]
 *  3.[生活博客汇总][Link 3]
 *  4.[喜马拉雅音频汇总][Link 4]
 *  5.[其他汇总][Link 5]

#### 02.关于我的博客 ####

*  我的个人站点：[www.yczbj.org][]，[www.ycbjie.cn][]
 *  github：[https://github.com/yangchong211][https_github.com_yangchong211]
 *  知乎：[https://www.zhihu.com/people/yang-chong-69-24/pins/posts][https_www.zhihu.com_people_yang-chong-69-24_pins_posts]
 *  简书：[http://www.jianshu.com/u/b7b2c6ed9284][http_www.jianshu.com_u_b7b2c6ed9284]
 *  csdn：[http://my.csdn.net/m0\_37700275][http_my.csdn.net_m0_37700275]
 *  喜马拉雅听书：[http://www.ximalaya.com/zhubo/71989305/][http_www.ximalaya.com_zhubo_71989305]
 *  开源中国：[https://my.oschina.net/zbj1618/blog][https_my.oschina.net_zbj1618_blog]
 *  泡在网上的日子：[http://www.jcodecraeer.com/member/content\_list.php?channelid=1][http_www.jcodecraeer.com_member_content_list.php_channelid_1]
 *  邮箱：yangchong211@163.com
 *  阿里云博客：[https://yq.aliyun.com/users/article?spm=5176.100-][https_yq.aliyun.com_users_article_spm_5176.100-] 239.headeruserinfo.3.dT4bcV
 *  segmentfault头条：[https://segmentfault.com/u/xiangjianyu/articles][https_segmentfault.com_u_xiangjianyu_articles]

转载于:https://www.cnblogs.com/yc211/p/9812813.html

[https_github.com_yangchong211_YCBlogs]: https://github.com/yangchong211/YCBlogs
[https_github.com_yangchong211_YCDialog]: https://github.com/yangchong211/YCDialog
[02.Toast]: https://github.com/yangchong211/YCBlogs/blob/master/android/Window/02.Toast%E6%BA%90%E7%A0%81%E6%B7%B1%E5%BA%A6%E5%88%86%E6%9E%90.md
[03.DialogFragment]: https://github.com/yangchong211/YCBlogs/blob/master/android/Window/03.DialogFragment%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90.md
[05.PopupWindow]: https://github.com/yangchong211/YCBlogs/blob/master/android/Window/05.PopupWindow%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90.md
[06.Snackbar]: https://github.com/yangchong211/YCBlogs/blob/master/android/Window/06.Snackbar%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90.md
[07.]: https://github.com/yangchong211/YCBlogs/blob/master/android/Window/07.%E5%BC%B9%E7%AA%97%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98.md
[image]: /images/20210724/256379c0fdf14ed8833d8479a814b98f.png
[image 1]: /images/20210724/9cd870f80a27444592508163469266d8.png
[image 2]: /images/20210724/0d80a515140f439f9543d93614290f32.png
[image 3]: /images/20210724/fa4fae73f5c648618e54252e6ec89d28.png
[Link 1]: https://www.jianshu.com/p/614cb839182c
[Link 2]: https://blog.csdn.net/m0_37700275/article/details/80863574
[Link 3]: https://blog.csdn.net/m0_37700275/article/details/79832978
[Link 4]: https://www.jianshu.com/p/f665de16d1eb
[Link 5]: https://www.jianshu.com/p/53017c3fc75d
[www.yczbj.org]: http://www.yczbj.org
[www.ycbjie.cn]: http://www.ycbjie.cn
[https_github.com_yangchong211]: https://github.com/yangchong211
[https_www.zhihu.com_people_yang-chong-69-24_pins_posts]: https://www.zhihu.com/people/yang-chong-69-24/pins/posts
[http_www.jianshu.com_u_b7b2c6ed9284]: http://www.jianshu.com/u/b7b2c6ed9284
[http_my.csdn.net_m0_37700275]: http://my.csdn.net/m0_37700275
[http_www.ximalaya.com_zhubo_71989305]: http://www.ximalaya.com/zhubo/71989305/
[https_my.oschina.net_zbj1618_blog]: https://my.oschina.net/zbj1618/blog
[http_www.jcodecraeer.com_member_content_list.php_channelid_1]: http://www.jcodecraeer.com/member/content_list.php?channelid=1
[https_yq.aliyun.com_users_article_spm_5176.100-]: https://yq.aliyun.com/users/article?spm=5176.100-
[https_segmentfault.com_u_xiangjianyu_articles]: https://segmentfault.com/u/xiangjianyu/articles