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的生命周期管理，被后台杀死后，可以恢复重建。

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

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.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

  • 自定义对话框，其中包括：自定义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.关于博客汇总链接

02.关于我的博客

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 157,298评论 4赞 360
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 66,701评论 1赞 290
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 107,078评论 0赞 237
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 43,687评论 0赞 202
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 52,018评论 3赞 286
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 40,410评论 1赞 211
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 31,729评论 2赞 310
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 30,412评论 0赞 194
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 34,124评论 1赞 239
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,379评论 2赞 242
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,903评论 1赞 257
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 28,268评论 2赞 251
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 32,894评论 3赞 233
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,014评论 0赞 8
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,770评论 0赞 192
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 35,435评论 2赞 269
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 35,312评论 2赞 260