学习笔记：
1、Qs创建
QSPanel 创建是从 StatusBar#makeStatusBarView 开始的，Qs面板创建这块，与之前版本对比，没啥变化。
protected void makeStatusBarView() {
// 省略其他代码......
// 设置快速设置面板
// R.id.qs_frame 是一个 FrameLayout 布局，将 QSFragment 布局添加到其中。所以 R.id.qs_frame 最终显示的是 QSFragment 。
final View container = mNotificationShadeWindowView.findViewById(R.id.qs_frame);
if (container != null) {
FragmentHostManager fragmentHostManager = FragmentHostManager.get(container);
ExtensionFragmentListener.attachExtensonToFragment(container, QS.TAG, R.id.qs_frame,
mExtensionController
.newExtension(QS.class)
.withPlugin(QS.class)
.withDefault(this::createDefaultQSFragment)
.build());
// 亮度控制器
mBrightnessMirrorController = new BrightnessMirrorController(
mNotificationShadeWindowView,
mNotificationPanelViewController,
mNotificationShadeDepthControllerLazy.get(),
mBrightnessSliderFactory,
(visible) -> {
mBrightnessMirrorVisible = visible;
updateScrimController();
});
fragmentHostManager.addTagListener(QS.TAG, (tag, f) -> {
QS qs = (QS) f;
if (qs instanceof QSFragment) {
mQSPanelController = ((QSFragment) qs).getQSPanelController();
((QSFragment) qs).setBrightnessMirrorController(mBrightnessMirrorController);
}
});
}
// 省略其他代码......
}
接下来就先看看 QSFragment 的 onCreateView() 方法：
QSFragment#onCreateView()
// QSFragment.java
@Override
public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container,
Bundle savedInstanceState) {
try {
Trace.beginSection("QSFragment#onCreateView");
inflater = inflater.cloneInContext(new ContextThemeWrapper(getContext(),
R.style.Theme_SystemUI_QuickSettings));
// 在这里返回了布局，R.layout.qs_panel
return inflater.inflate(R.layout.qs_panel, container, false);
} finally {
Trace.endSection();
}
}
再看 QSFragment 的构造函数：
// QSFragment.java
@Inject
public QSFragment(RemoteInputQuickSettingsDisabler remoteInputQsDisabler,
QSTileHost qsTileHost,
StatusBarStateController statusBarStateController, CommandQueue commandQueue,
@Named(QS_PANEL) MediaHost qsMediaHost,
@Named(QUICK_QS_PANEL) MediaHost qqsMediaHost,
KeyguardBypassController keyguardBypassController,
QSFragmentComponent.Factory qsComponentFactory,
QSFragmentDisableFlagsLogger qsFragmentDisableFlagsLogger,
FalsingManager falsingManager, DumpManager dumpManager) {
// 省略其他代码......
mHost = qsTileHost;
// 省略其他代码......
}
这里注意 @Inject 注解，这个是 Android dagger里的一种注解。
在这里，与Android 9.0及其以下版本实例化 QSTileHost类的方式不一样，这里是通dagger来实例化的。所以这里实例化了 QSTileHost 。
下面我们就进入到 QSTileHost 的构造方法：
// QSTileHost.java
@Inject
public QSTileHost(Context context,
StatusBarIconController iconController,
QSFactory defaultFactory,
@Main Handler mainHandler,
@Background Looper bgLooper,
PluginManager pluginManager,
TunerService tunerService,
Provider<AutoTileManager> autoTiles,
DumpManager dumpManager,
BroadcastDispatcher broadcastDispatcher,
Optional<CentralSurfaces> centralSurfacesOptional,
QSLogger qsLogger,
UiEventLogger uiEventLogger,
UserTracker userTracker,
SecureSettings secureSettings,
CustomTileStatePersister customTileStatePersister,
TileServiceRequestController.Builder tileServiceRequestControllerBuilder,
TileLifecycleManager.Factory tileLifecycleManagerFactory
) {
// 省略其他代码......
mainHandler.post(() -> {
// This is technically a hack to avoid circular dependency of
// QSTileHost -> XXXTile -> QSTileHost. Posting ensures creation
// 在创建任何图块之前完成。
tunerService.addTunable(this, TILES_SETTING);
// AutoTileManager 可以修改 mTiles，因此请确保 mTiles 已经初始化。
mAutoTiles = autoTiles.get();
mTileServiceRequestController.init();
});
}
在 QSTileHost 的构造函数里，我们主要看 tunerService.addTunable(this, TILES_SETTING); 很明显，调用 tunerService 里的 addTunabe() 方法，跟进去会发现，最终的是调用的 TunerServiceImpl 里面的 addTunabe() 方法。
TunerServiceImpl#addTunable()
// TunerServiceImpl.java
public void addTunable(Tunable tunable, String... keys) {
for (String key : keys) {
addTunable(tunable, key);
}
}
private void addTunable(Tunable tunable, String key) {
// 省略其他代码......
// 从数据库读取数据；刷机第一次数据库为空，这里也会空，后面程序会从配置文件读取；
String value = DejankUtils.whitelistIpcs(() -> Settings.Secure
.getStringForUser(mContentResolver, key, mCurrentUser));
tunable.onTuningChanged(key, value);
}
tunable.onTuningChanged() 回调 QSTileHost#onTuningChanged():
// QSTileHost.java
@Override
public void onTuningChanged(String key, String newValue) {
if (!TILES_SETTING.equals(key)) {
return;
}
if (DEBUG) Log.d(TAG, "Recreating tiles");
if (newValue == null && UserManager.isDeviceInDemoMode(mContext)) {
newValue = mContext.getResources().getString(R.string.quick_settings_tiles_retail_mode);
}
//调用 QSTileHost#loadTileSpecs，获得 config 里字符串信息
final List<String> tileSpecs = loadTileSpecs(mContext, newValue);
int currentUser = ActivityManager.getCurrentUser();
if (tileSpecs.equals(mTileSpecs) && currentUser == mCurrentUser) return;
//进行了过滤
mTiles.entrySet().stream().filter(tile -> !tileSpecs.contains(tile.getKey())).forEach(
tile -> {
if (DEBUG) Log.d(TAG, "Destroying tile: " + tile.getKey());
tile.getValue().destroy();
});
final LinkedHashMap<String, QSTile> newTiles = new LinkedHashMap<>();
for (String tileSpec : tileSpecs) {
QSTile tile = mTiles.get(tileSpec);
if (tile != null && (!(tile instanceof CustomTile)
|| ((CustomTile) tile).getUser() == currentUser)) {
if (tile.isAvailable()) {
if (DEBUG) Log.d(TAG, "Adding " + tile);
tile.removeCallbacks();
if (!(tile instanceof CustomTile) && mCurrentUser != currentUser) {
tile.userSwitch(currentUser);
}
newTiles.put(tileSpec, tile);
} else {
tile.destroy();
}
} else {
if (DEBUG) Log.d(TAG, "Creating tile: " + tileSpec);
try {
//这里通过 字符串 一个个实例化 Tile
tile = createTile(tileSpec);
if (tile != null) {
if (tile.isAvailable()) {
tile.setTileSpec(tileSpec);
// put 到 Map 中
newTiles.put(tileSpec, tile);
} else {
tile.destroy();
}
}
} catch (Throwable t) {
Log.w(TAG, "Error creating tile for spec: " + tileSpec, t);
}
}
}
mCurrentUser = currentUser;
mTileSpecs.clear();
mTileSpecs.addAll(tileSpecs);
mTiles.clear();
// put 到 Map 中
mTiles.putAll(newTiles);
for (int i = 0; i < mCallbacks.size(); i++) {
//注册，当开发状态改变时回调
mCallbacks.get(i).onTilesChanged();
}
}
这里有两个重要的方法：一个是获取 config 里字符串信息 loadTileSpecs(mContext, newValue)；一个实例化 Tile 的 createTile(tileSpec)。
先看第一个 QSTileHost#loadTileSpecs() 这里和Android 10 有点出入。
// QSTileHost.java
protected static List<String> loadTileSpecs(Context context, String tileList) {
final Resources res = context.getResources();
// tileList 为空，则获取一个 “default” 字符串
if (TextUtils.isEmpty(tileList)) {
tileList = res.getString(R.string.quick_settings_tiles);
if (DEBUG) Log.d(TAG, "Loaded tile specs from config: " + tileList);
} else {
if (DEBUG) Log.d(TAG, "Loaded tile specs from setting: " + tileList);
}
final ArrayList<String> tiles = new ArrayList<String>();
boolean addedDefault = false;
Set<String> addedSpecs = new ArraySet<>();
for (String tile : tileList.split(",")) {
tile = tile.trim();
if (tile.isEmpty()) continue;
// 第一次 tileList 为空，取了默认值，
if (tile.equals("default")) {
if (!addedDefault) {
// 从 config 文件获取
List<String> defaultSpecs = getDefaultSpecs(context);
for (String spec : defaultSpecs) {
if (!addedSpecs.contains(spec)) {
tiles.add(spec);
addedSpecs.add(spec);
}
}
addedDefault = true;
}
} else {
if (!addedSpecs.contains(tile)) {
tiles.add(tile);
addedSpecs.add(tile);
}
}
}
// 省略其他代码......
return tiles;
}
上述代码中第一次 tileList 为空，调用了 getDefaultSpecs(context) 获取字符串，该方法比较简单，这里就不做分析了。
接着看第二个 QSTileHost#createTile(tileSpec) 方法：
public QSTile createTile(String tileSpec) {
for (int i = 0; i < mQsFactories.size(); i++) {
QSTile t = mQsFactories.get(i).createTile(tileSpec);
if (t != null) {
return t;
}
}
// M: @ {
if (mQuickSettingsExt != null && mQuickSettingsExt.doOperatorSupportTile(tileSpec)) {
// WifiCalling
return (QSTile) mQuickSettingsExt.createTile(this, tileSpec);
}
// @ }
return null;
}
这里调用 QSFactory#createTile()，而 QSFactory 接口又由 QSFactoryImpl 实现。所以这里直接看 QSFactoryImpl #createTile()：
// QSFactoryImpl.java
public QSTile createTile(String tileSpec) {
QSTileImpl tile = createTileInternal(tileSpec);
if (tile != null) {
tile.handleStale(); // Tile was just created, must be stale.
}
return tile;
}
private QSTileImpl createTileInternal(String tileSpec) {
// 省略其他代码......
// Stock tiles.
switch (tileSpec) {
case "wifi":
return mWifiTileProvider.get();
case "internet":
return mInternetTileProvider.get();
case "bt":
return mBluetoothTileProvider.get();
case "cell":
return mCellularTileProvider.get();
case "dnd":
return mDndTileProvider.get();
case "inversion":
return mColorInversionTileProvider.get();
case "airplane":
return mAirplaneModeTileProvider.get();
case "work":
return mWorkModeTileProvider.get();
case "rotation":
return mRotationLockTileProvider.get();
case "flashlight":
return mFlashlightTileProvider.get();
case "location":
return mLocationTileProvider.get();
case "cast":
return mCastTileProvider.get();
case "hotspot":
return mHotspotTileProvider.get();
case "battery":
return mBatterySaverTileProvider.get();
case "saver":
return mDataSaverTileProvider.get();
case "night":
return mNightDisplayTileProvider.get();
case "nfc":
return mNfcTileProvider.get();
case "dark":
return mUiModeNightTileProvider.get();
case "screenrecord":
return mScreenRecordTileProvider.get();
// 省略其他代码......
}
// 省略其他代码......
return null;
}
看到这里通过对应的字符串分别实例化了对应的 Tile。
2、Qs显示
以上涉及资源文件加载及对应实例化，接下来看看如何显示出来的。和Android 11 对比出入有点大，加了一个控制器。
这里要回到 QSFragment#onViewCreated() 方法：
// QSFragment.java
@Override
public void onViewCreated(View view, @Nullable Bundle savedInstanceState) {
QSFragmentComponent qsFragmentComponent = mQsComponentFactory.create(this);
mQSPanelController = qsFragmentComponent.getQSPanelController();
mQuickQSPanelController = qsFragmentComponent.getQuickQSPanelController();
mQSFooterActionController = qsFragmentComponent.getQSFooterActionController();
// 一些初始化，init() 是 抽象类 ViewController 的 public 方法。
mQSPanelController.init();
mQuickQSPanelController.init();
mQSFooterActionController.init();
// 扩展的 qs 滚动视图
mQSPanelScrollView = view.findViewById(R.id.expanded_qs_scroll_view);
// 省略其他代码......
}
经过上述分析，我们来看看 ViewController#init()：
public void init() {
if (mInited) {
return;
}
onInit(); // 要在 onViewAttached() 方法之前运行，
mInited = true;
if (isAttachedToWindow()) {
// 调用内部 onViewAttachedToWindow() 方法，去添加视图。
mOnAttachStateListener.onViewAttachedToWindow(mView);
}
addOnAttachStateChangeListener(mOnAttachStateListener);
}
private OnAttachStateChangeListener mOnAttachStateListener = new OnAttachStateChangeListener() {
@Override
public void onViewAttachedToWindow(View v) {
// 调用自己的抽象方法 onViewAttached() ，在子类具体实现，添加 Tiles.
ViewController.this.onViewAttached();
}
@Override
public void onViewDetachedFromWindow(View v) {
ViewController.this.onViewDetached();
}
};
这个添加在 QSPanelController 的父类 QSPanelControllerBase 中的 onViewAttached() 方法中。
QSPanelControllerBase#onViewAttached()
// QSPanelControllerBase.java
@Override
protected void onViewAttached() {
mQsTileRevealController = createTileRevealController();
if (mQsTileRevealController != null) {
mQsTileRevealController.setExpansion(mRevealExpansion);
}
mMediaHost.addVisibilityChangeListener(mMediaHostVisibilityListener);
mView.addOnConfigurationChangedListener(mOnConfigurationChangedListener);
mHost.addCallback(mQSHostCallback);
// 这里设置 Tiles
setTiles();
mLastOrientation = getResources().getConfiguration().orientation;
switchTileLayout(true);
mDumpManager.registerDumpable(mView.getDumpableTag(), this);
}
/** */
public void setTiles() {
// 这里 getTiles() 就是获取，前面我们说的 Tiles 实例，在 QSTileHost 中。
setTiles(mHost.getTiles(), false);
}
/** */
public void setTiles(Collection<QSTile> tiles, boolean collapsedView) {
// TODO(b/168904199): move this logic into QSPanelController.
if (!collapsedView && mQsTileRevealController != null) {
mQsTileRevealController.updateRevealedTiles(tiles);
}
for (QSPanelControllerBase.TileRecord record : mRecords) {
mView.removeTile(record);
record.tile.removeCallback(record.callback);
}
mRecords.clear();
mCachedSpecs = "";
for (QSTile tile : tiles) {
addTile(tile, collapsedView);
}
}
private void addTile(final QSTile tile, boolean collapsedView) {
// 这里会创建对应的视图。
final TileRecord r =
new TileRecord(tile, mHost.createTileView(getContext(), tile, collapsedView));
// 注意：这个 mView 是 QSPanel，在 QSPanelController 的构造方法通过super传到 QSPanelControllerBase 的。这里也是视图的添加。
mView.addTile(r);
mRecords.add(r);
mCachedSpecs = getTilesSpecs();
}
这里只需关注QSPanel#addTile():
// QSPanel.java
void addTile(QSPanelControllerBase.TileRecord tileRecord) {
final QSTile.Callback callback = new QSTile.Callback() {
@Override
public void onStateChanged(QSTile.State state) {
drawTile(tileRecord, state);
}
};
tileRecord.tile.addCallback(callback);
tileRecord.callback = callback;
tileRecord.tileView.init(tileRecord.tile);
tileRecord.tile.refreshState();
if (mTileLayout != null) {
mTileLayout.addTile(tileRecord);
}
}
由 TileLayout#addTile() 实现:
// TileLayout.java
public void addTile(TileRecord tile) {
mRecords.add(tile);
tile.tile.setListening(this, mListening);
addTileView(tile);
}
protected void addTileView(TileRecord tile) {
// 注：TileLayout 继承的是 ViewGroup。
addView(tile.tileView);
}
至此，SystemUI 下拉状态栏快捷开关模块代码流程分析完毕。
Qs一个有3种呈现方式，如图：
Qs页面.png
我这分析的是第 2 种。
其他的展示方法也类似。
qs_panel.xml 布局文件
<com.android.systemui.qs.QSContainerImpl xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/quick_settings_container"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:clipToPadding="false"
android:clipChildren="false">
<!-- 第二种布局 -->
<com.android.systemui.qs.NonInterceptingScrollView
android:id="@+id/expanded_qs_scroll_view"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:elevation="@dimen/qs_panel_elevation"
android:importantForAccessibility="no"
android:scrollbars="none"
android:clipChildren="false"
android:clipToPadding="false"
android:layout_weight="1">
<com.android.systemui.qs.QSPanel
android:id="@+id/quick_settings_panel"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@android:color/transparent"
android:focusable="true"
android:accessibilityTraversalBefore="@android:id/edit"
android:clipToPadding="false"
android:clipChildren="false">
<include layout="@layout/qs_footer_impl" />
</com.android.systemui.qs.QSPanel>
</com.android.systemui.qs.NonInterceptingScrollView>
<!-- 第一种布局 -->
<include layout="@layout/quick_status_bar_expanded_header" />
<include
layout="@layout/footer_actions"
android:id="@+id/qs_footer_actions"
android:layout_height="@dimen/footer_actions_height"
android:layout_width="match_parent"
android:layout_gravity="bottom"
/>
<!-- 第三种布局 -->
<include
android:id="@+id/qs_customize"
layout="@layout/qs_customize_panel"
android:visibility="gone" />
</com.android.systemui.qs.QSContainerImpl>
