一、 问题描述
最近项目中有个需求：一个页面顶部有3个tab,每一个tab分别展示一个不同的页面，点击tab 切换到对应页面。进入页面是默认选中第一个页面。
这不很简单的一个需求嘛？很明显，用TabLayout 分分钟实现，于是打开Android Studio ,几分钟后写下了如下代码：
public class TabActivity extends AppCompatActivity {private TabLayout mTabLayout;@Overrideprotected void onCreate(@Nullable Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.tab_layout_ac2);mTabLayout = (TabLayout) findViewById(R.id.tab_layout2);mTabLayout.addTab(mTabLayout.newTab().setText("个性推荐"),true);//设置默认选中mTabLayout.addTab(mTabLayout.newTab().setText("歌单"));mTabLayout.addTab(mTabLayout.newTab().setText("主播电台"));final List<Fragment> fragments = new ArrayList<>();fragments.add(FirstFragment.newInstance());fragments.add(SecondFragment.newInstance());fragments.add(ThirdFragment.newInstance());mTabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {@Overridepublic void onTabSelected(TabLayout.Tab tab) {Log.e("TAG","tab position:"+tab.getPosition());replaceFragment(fragments.get(tab.getPosition()));}@Overridepublic void onTabUnselected(TabLayout.Tab tab) {}@Overridepublic void onTabReselected(TabLayout.Tab tab) {}});}private void replaceFragment(Fragment fragment){getSupportFragmentManager().beginTransaction().replace(R.id.tab_container,fragment).commit();}
}写完之后，一运行，发现tab 显示出来了，第一个tab也选中了（效果如下图），但是第一页的内容咋没展示出来呢？ 然后点击tab切换，切换到后面2个tab时，可以加载出页面，然后再次点击第一个tab ,第一个tab 的页面也展示出来了。
第一次进来时，tab 下面的页面内容没有展示出来，很明显，那就是第一次进来的时候onTabSelected 回调没有被执行。因为我们是在onTabSelected 来加载页面的。经过几次反复测试（日志和断点调试），确定了是第一次进入的时候，onTabSelected没有被回调。
那么，为什么第一次进入的时候，onTabSelected没有被回调了？反复检查了几次代码，没有发现问题。既然没有发现问题，那么，我们就只有去看源码了，看一下TabLayoout 初始化完成后，在什么时候调用的onTabSelected 回调方法？
二、源码追踪
我们要看一下源码中TabLayout初始化后，在什么时候调用的onTabSelected。我们注意到，添加Tab的时候，有这么一个方法：
mTabLayout.addTab(mTabLayout.newTab().setText("个性推荐"),true);
addTab 方法有2个参数，第一个是要添加的Tab,第二个参数是是否设置为默认选中。上面这行代码的意思是，添加一个Tab，并且设置这个tab为默认选中的Tab。
接下来就走读一下源码，看一下在何时回调的onTabSelected方法：
1,首先看一下OnTabSelectedListener 的设置
public void addOnTabSelectedListener(@NonNull OnTabSelectedListener listener) {if (!mSelectedListeners.contains(listener)) {mSelectedListeners.add(listener);}}
很简单，就是将OnTabSelectedListener保存到一个列表里。没有做其他事情。
2, 以 addTab 方法为入口，顺藤摸瓜。
// 添加一个Tab ,并且设置为是否选中// 实际调用方法 addTab(@NonNull Tab tab, int position, boolean setSelected) public void addTab(@NonNull Tab tab, boolean setSelected) {addTab(tab, mTabs.size(), setSelected);}//1, 首先将Tab 保存到一个列表中，记录位置//2, 将tab 添加到TabLayout 中//3, 判断时候选中（这就是我们要的）public void addTab(@NonNull Tab tab, int position, boolean setSelected) {if (tab.mParent != this) {throw new IllegalArgumentException("Tab belongs to a different TabLayout.");}configureTab(tab, position);addTabView(tab);// 是否选中if (setSelected) {tab.select();}}
如上代码，如果setSelected为true,就调用了tab 的select()方法，我们看一下select()方法：
public void select() {if (mParent == null) {throw new IllegalArgumentException("Tab not attached to a TabLayout");}mParent.selectTab(this);}
调用了Parent的select方法，Parent 是谁？当然是TabLayout 啦。所以继续深入，看看TabLayout的select方法。
void selectTab(Tab tab) {//实际调用 selectTab(final Tab tab, boolean updateIndicator) selectTab(tab, true);}// void selectTab(final Tab tab, boolean updateIndicator) {final Tab currentTab = mSelectedTab;if (currentTab == tab) { // 如果新选中的Tab 和当前Tab 相同，回调onTabReselected 方法if (currentTab != null) {dispatchTabReselected(tab);animateToTab(tab.getPosition());}} else { // 如果不同，则回调 onTabSelected方法final int newPosition = tab != null ? tab.getPosition() : Tab.INVALID_POSITION;if (updateIndicator) {if ((currentTab == null || currentTab.getPosition() == Tab.INVALID_POSITION)&& newPosition != Tab.INVALID_POSITION) {// If we don't currently have a tab, just draw the indicatorsetScrollPosition(newPosition, 0f, true);} else {animateToTab(newPosition);}if (newPosition != Tab.INVALID_POSITION) {setSelectedTabView(newPosition);}}if (currentTab != null) {dispatchTabUnselected(currentTab);}mSelectedTab = tab; // 记录选中的Tab if (tab != null) {dispatchTabSelected(tab); // 处理选中Tab }}}
TabLayout 的selectTab方法中最终调用了dispatchTabSelected方法：
private void dispatchTabSelected(@NonNull final Tab tab) {for (int i = mSelectedListeners.size() - 1; i >= 0; i--) {mSelectedListeners.get(i).onTabSelected(tab); // 找到了，在这里循环列表，分别调用onTabSelected 方法。}}
好了，到这里就找到了onTabSelected回调的地方了，有没有很熟悉 mSelectedListeners?当然了，在我们调用addOnTabSelectedListener设置监听器的时候，就是保存到mSelectedListeners的。我们来捋一捋：
如上图：
当我们执行addTab方法添加Tab的时候，最后会调用到 dispatchTabSelected方法，在dispatchTabSelected方法里面调用addOnTabSelectedListener 的onTabSelected()方法。但是这个时候，mSelectedListeners 为空(因为这个时候我们还没有设置OnTabSelectedListener)，因此，就没有回调到onTabSelected。
分析到此我们也就明白了，第一次没有回调到 onTabSelected 方法，是因为我们写的程序的顺序问题，应该在添加Tab 之前 添加OnTabSelectedListener 监听。
三、解决方案
通过上面的源码分析，我们知道了，第一次没有执行OnTabSelected回调，是因为我们的代码顺序问题（这个是Google 的坑，设计得有问题啊），因此，要想第一次进入的时候回调到OnTabSelected方法，我们应该先设置
addOnTabSelectedListener 监听器，再添加Tab，我们原来的程序顺序调整一下：
// 1, 设置 addOnTabSelectedListener// 设置 addOnTabSelectedListener 必须在 addTab 之前。mTabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {@Overridepublic void onTabSelected(TabLayout.Tab tab) {Log.e("TAG","tab position:"+tab.getPosition());replaceFragment(fragments.get(tab.getPosition()));}@Overridepublic void onTabUnselected(TabLayout.Tab tab) {}@Overridepublic void onTabReselected(TabLayout.Tab tab) {}});// 2.添加Tab mTabLayout.addTab(mTabLayout.newTab().setText("个性推荐"),true);mTabLayout.addTab(mTabLayout.newTab().setText("歌单"));mTabLayout.addTab(mTabLayout.newTab().setText("主播电台"));
通过如上调整，再运行程序，完美解决，第一次进入如下：
四、总结
本篇文章是对TabLayout 使用过程中遇到的一个的坑记录和总结，可能有的人不会遇到，也没有人会注意到（如果你一开始就把顺序写对了的话），但是，如果遇到的话，要看源码才知道原因。这也是我们解决问题的一种思路。很多时候，我们需要去了解一下原理和源码的实现，这样才能帮助我们更好的理解，以免使用的时候踩坑。