TabLayout 踩坑之 onTabSelected 没有被回调的问题

   <p><img src="https://simg.open-open.com/show/eb7fb20d484832f466aa3812599115df.png"></p>    <h2>一、 问题描述</h2>    <p>最近项目中有个需求：一个页面顶部有3个tab,每一个tab分别展示一个不同的页面，点击tab 切换到对应页面。进入页面是默认选中第一个页面。</p>    <p>这不很简单的一个需求嘛？很明显，用TabLayout 分分钟实现，于是打开Android Studio ,几分钟后写下了如下代码：</p>    <pre>  <code class="language-java">public class TabActivity extends AppCompatActivity {      private TabLayout mTabLayout;      @Override      protected 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() {              @Override              public void onTabSelected(TabLayout.Tab tab) {                  Log.e("TAG","tab position:"+tab.getPosition());                  replaceFragment(fragments.get(tab.getPosition()));              }                @Override              public void onTabUnselected(TabLayout.Tab tab) {                }                @Override              public void onTabReselected(TabLayout.Tab tab) {                }          });      }        private void replaceFragment(Fragment fragment){          getSupportFragmentManager().beginTransaction().replace(R.id.tab_container,fragment).commit();      }  }</code></pre>    <p>写完之后，一运行，发现tab 显示出来了，第一个tab也选中了（效果如下图），但是第一页的内容咋没展示出来呢？ 然后点击tab切换，切换到后面2个tab时，可以加载出页面，然后再次点击第一个tab ,第一个tab 的页面也展示出来了。</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/3cfb0a43036df87b4f87092b2871b5a9.png"></p>    <p style="text-align:center">未展示页面效果.png</p>    <p>第一次进来时，tab 下面的页面内容没有展示出来，很明显，那就是第一次进来的时候onTabSelected 回调没有被执行。因为我们是在onTabSelected 来加载页面的。经过几次反复测试（日志和断点调试），确定了是第一次进入的时候，onTabSelected没有被回调。</p>    <p>那么，为什么第一次进入的时候，onTabSelected没有被回调了？反复检查了几次代码，没有发现问题。 既然没有发现问题，那么，我们就只有去看源码了，看一下TabLayoout 初始化完成后，在什么时候调用的onTabSelected 回调方法？</p>    <h2>二、源码追踪</h2>    <p>我们要看一下源码中TabLayout初始化后，在什么时候调用的onTabSelected。我们注意到，添加Tab的时候，有这么一个方法：</p>    <pre>  <code class="language-java">mTabLayout.addTab(mTabLayout.newTab().setText("个性推荐"),true);</code></pre>    <p>addTab 方法有2个参数，第一个是要添加的Tab,第二个参数是是否设置为默认选中。上面这行代码的意思是，添加一个Tab，并且设置这个tab为默认选中的Tab。</p>    <p>接下来就走读一下源码，看一下在何时回调的 onTabSelected 方法：</p>    <p>1,首先看一下OnTabSelectedListener 的设置</p>    <pre>  <code class="language-java">public void addOnTabSelectedListener(@NonNull OnTabSelectedListener listener) {          if (!mSelectedListeners.contains(listener)) {              mSelectedListeners.add(listener);          }      }</code></pre>    <p>很简单，就是将OnTabSelectedListener保存到一个列表里。没有做其他事情。</p>    <p>2, 以 addTab 方法为入口，顺藤摸瓜。</p>    <pre>  <code class="language-java">// 添加一个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();          }      }</code></pre>    <p>如上代码，如果 setSelected 为 true ,就调用了tab 的 select() 方法，我们看一下 select() 方法：</p>    <pre>  <code class="language-java">public void select() {              if (mParent == null) {                  throw new IllegalArgumentException("Tab not attached to a TabLayout");              }              mParent.selectTab(this);          }</code></pre>    <p>调用了Parent的 select 方法，Parent 是谁？当然是TabLayout 啦。所以继续深入，看看TabLayout的 select 方法。</p>    <pre>  <code class="language-java">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 indicator                      setScrollPosition(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               }          }      }</code></pre>    <p>TabLayout 的 selectTab 方法中最终调用了dispatchTabSelected方法：</p>    <pre>  <code class="language-java">private void dispatchTabSelected(@NonNull final Tab tab) {          for (int i = mSelectedListeners.size() - 1; i >= 0; i--) {              mSelectedListeners.get(i).onTabSelected(tab); // 找到了，在这里循环列表，分别调用onTabSelected 方法。          }      }</code></pre>    <p>好了，到这里就找到了 onTabSelected 回调的地方了，有没有很熟悉 mSelectedListeners ?当然了，在我们调用 addOnTabSelectedListener 设置监听器的时候，就是保存到 mSelectedListeners 的。我们来捋一捋：</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/38dda1f8c17a8b5c86fd48b73d90af5d.png"></p>    <p style="text-align:center">源码流程.png</p>    <p>如上图：</p>    <p>当我们执行addTab方法添加Tab的时候，最后会调用到 dispatchTabSelected 方法，在 dispatchTabSelected 方法里面调用 addOnTabSelectedListener 的 onTabSelected() 方法。但是这个时候，mSelectedListeners 为空(因为这个时候我们还没有设置OnTabSelectedListener)，因此，就没有回调到 onTabSelected 。</p>    <p>分析到此我们也就明白了，第一次没有回调到 onTabSelected 方法，是因为我们写的程序的顺序问题，应该在添加Tab 之前 添加OnTabSelectedListener 监听。</p>    <h2>三、解决方案</h2>    <p>通过上面的源码分析，我们知道了，第一次没有执行OnTabSelected回调，是因为我们的代码顺序问题（这个是Google 的坑，设计得有问题啊），</p>    <p>因此，要想第一次进入的时候回调到OnTabSelected方法，我们应该先设置</p>    <p>addOnTabSelectedListener 监听器，再添加Tab</p>    <p>，我们原来的程序顺序调整一下：</p>    <pre>  <code class="language-java">// 1, 设置 addOnTabSelectedListener          // 设置 addOnTabSelectedListener 必须在 addTab 之前。          mTabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {              @Override              public void onTabSelected(TabLayout.Tab tab) {                  Log.e("TAG","tab position:"+tab.getPosition());                  replaceFragment(fragments.get(tab.getPosition()));              }                @Override              public void onTabUnselected(TabLayout.Tab tab) {                }                @Override              public void onTabReselected(TabLayout.Tab tab) {                }          });          // 2.添加Tab           mTabLayout.addTab(mTabLayout.newTab().setText("个性推荐"),true);          mTabLayout.addTab(mTabLayout.newTab().setText("歌单"));          mTabLayout.addTab(mTabLayout.newTab().setText("主播电台"));</code></pre>    <p>通过如上调整，再运行程序，完美解决，第一次进入如下：</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/3c2374fc4f1755ae1f5b29d0ef0fa825.png"></p>    <p style="text-align:center">展示了页面内容效果.png</p>    <h2>四、总结</h2>    <p>本篇文章是对TabLayout 使用过程中遇到的一个的坑记录和总结，可能有的人不会遇到，也没有人会注意到（如果你一开始就把顺序写对了的话），但是，如果遇到的话，要看源码才知道原因。这也是我们解决问题的一种思路。很多时候，我们需要去了解一下原理和源码的实现，这样才能帮助我们更好的理解，以免使用的时候踩坑。</p>    <p> </p>    <p>来自：https://juejin.im/post/58f489630ce463006bbb483e</p>    <p> </p>