Android 6.0 Setting模块解析（一）
这几天在学习 Android Settings 设置菜单的相关内容，原本打算一篇搞定，谁知入坑后发现 Android 6.0、7.0、8.0 设置菜单的加载方式各有千秋，妈耶，好坑，所以接下来我会从 6.0、7.0、8.0 去分别分析设置界面是怎么加载出来的。预计会分为三篇，本篇是第一篇 6.0 分析，下面请各位跟我的教程一步步走，喂喂喂！！说你呢，小本本拿好，我要开讲啦！！
前言
偷偷告诉你 Android 源码和本篇文章结合起来看效果更好哦。
Android 源码查看地址：https://www.androidos.net.cn/sourcecode 。
另外本系列文章所涉及的所有 Android 源码在此网站上都可以找到，最后来看看 6.0 系统的设置菜单到底长什么样，瞅图：
在这里插入图片描述
6.0设置界面加载
首先我们来看 Settings 模块中的 AndroidManifest.xml 文件，这里会展示四大组件，默认启动入口Activity等信息，具体路径如下：/packages/apps/Settings/AndroidManifest.xml。
···
<activity android:name="Settings"
android:taskAffinity="com.android.settings"
android:label="@string/settings_label_launcher"
android:launchMode="singleTask">
<intent-filter android:priority="1">
<action android:name="android.settings.SETTINGS" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
<meta-data android:name="com.android.settings.PRIMARY_PROFILE_CONTROLLED"
android:value="true" />
</activity>
//activity-alias可用来设置某个Activity的快捷入口，可以放在桌面上或者通过该别名被其他组件快速调起。
//android:targetActivity为目标Activity.
<activity-alias android:name="Settings"
android:taskAffinity="com.android.settings" android:label="@string/settings_label_launcher"
android:launchMode="singleTask"
android:targetActivity="Settings">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity-alias>
···
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
可以看出入口Activity为Settings。
Settings
具体路径：/packages/apps/Settings/src/com/android/settings/Settings.java
public class Settings extends SettingsActivity {
public static class BluetoothSettingsActivity extends SettingsActivity { /* empty */ }
public static class WirelessSettingsActivity extends SettingsActivity { /* empty */ }
public static class SimSettingsActivity extends SettingsActivity { /* empty */ }
···
}
1
2
3
4
5
6
可以看出 Settings 继承于 SettingsActivity ，而且其内部都是类的空实现。所以我们看其父类 SettingsActivity。
SettingsActivity
查看其类会发现，SettingsActivity 便是加载菜单的主 Activity。
它的具体路径为：/packages/apps/Settings/src/com/android/settings/SettingsActivity.java
首先来分析 onCreate() 方法
@Override
protected void onCreate(Bundle savedState) {
super.onCreate(savedState);
···
//获取AndroidManiFest.xml中mate数据，从Settings（或桌面快捷图标）进入时获取是null
getMetaData();
//布局窗口UI
final Intent intent = getIntent();
if (intent.hasExtra(EXTRA_UI_OPTIONS)) {
getWindow().setUiOptions(intent.getIntExtra(EXTRA_UI_OPTIONS, 0));
}
···
}
1
2
3
4
5
6
7
8
9
10
11
12
13
getMetaData() 代码如下
private void getMetaData() {
try {
ActivityInfo ai = getPackageManager().getActivityInfo(getComponentName(),
PackageManager.GET_META_DATA);
if (ai == null || ai.metaData == null) return;
//private static final String META_DATA_KEY_FRAGMENT_CLASS =
//"com.android.settings.FRAGMENT_CLASS";
mFragmentClass = ai.metaData.getString(META_DATA_KEY_FRAGMENT_CLASS);
} catch (NameNotFoundException nnfe) {
···
}
}
1
2
3
4
5
6
7
8
9
10
11
12
由此可知，getMetaData() 会在加载对应的设置项时会从 节点下获取到 fragmentclass 的值，即为含有 com.android.settings.FRAGMENT_CLASS 标签的值，进行加载。
接下来看getIntent()代码：
@Override
public Intent getIntent() {
Intent superIntent = super.getIntent();
//获取到要跳转的fragment
String startingFragment = getStartingFragmentClass(superIntent);
if (startingFragment != null) {
Intent modIntent = new Intent(superIntent);
modIntent.putExtra(EXTRA_SHOW_FRAGMENT, startingFragment);
Bundle args = superIntent.getExtras();
if (args != null) {
args = new Bundle(args);
} else {
args = new Bundle();
}
args.putParcelable("intent", superIntent);
modIntent.putExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS, args);
return modIntent;
}
return superIntent;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
接着看onCreate()方法
@Override
protected void onCreate(Bundle savedState) {
super.onCreate(savedState);
···
//获取到要显示的fragment
final String initialFragmentName = intent.getStringExtra(EXTRA_SHOW_FRAGMENT);
//判断是否属于快捷方式
//isShortCutIntent(intent)是获取到配置文件中定义的<category..节点下的数据判断是否包含某个字符串 //isLikeShortCutIntent方法 是获取到<action..，判断是否有特定的action，如果有就属于快捷方式
//或者判断key为EXTRA_SHOW_FRAGMENT_AS_SHORTCUT中的值是否为true
mIsShortcut = isShortCutIntent(intent) || isLikeShortCutIntent(intent) ||
intent.getBooleanExtra(EXTRA_SHOW_FRAGMENT_AS_SHORTCUT, false);
////获取到组件名
final ComponentName cn = intent.getComponent();
//获取到类名
final String className = cn.getClassName();
//如果类名为Settings的类名，则为正在显示控制面板（设置主页）
mIsShowingDashboard = className.equals(Settings.class.getName());
//获取到所加载的activity是否属于SubSettings
//this instanceof SubSettings:判断activity是否属于SubSettings
//或者获取到EXTRA_SHOW_FRAGMENT_AS_SUBSETTINGS的值,该key会在加载BluetoothSettings时进行赋值
final boolean isSubSettings = this instanceof SubSettings ||
intent.getBooleanExtra(EXTRA_SHOW_FRAGMENT_AS_SUBSETTING, false);
···
//加载布局文件，如果显示的设置主界面，即mIsShowingDashboard为true，所以加载settings_main_dashboard布局
setContentView(mIsShowingDashboard ?
R.layout.settings_main_dashboard : R.layout.settings_main_prefs);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
接下来看布局文件settings_main_dashboard.xml
具体路径如下：/packages/apps/Settings/res/layout/settings_main_dashboard.xml
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/main_content"
android:layout_height="match_parent"
android:layout_width="match_parent"
/>
1
2
3
4
5
可以看出是个帧布局，里面什么都没有，ok 接下来继续看 onCreat 代码：
@Override
protected void onCreate(Bundle savedState) {
super.onCreate(savedState);
//为fragment所存在的栈添加监听事件
getFragmentManager().addOnBackStackChangedListener(this);
//如果当前显示的为主面板，则会进行如下操作
if (mIsShowingDashboard) {
//isLowStorage方法 用于判断我们是否运行在低存储空间
if (!Utils.isLowStorage(this)) {
//如果存储空间足够的话，则进行update，即通过ContentProvider来读取数数据，并添加到一个list列表中，这些list列表中存放的是设置项的相关信息
Index.getInstance(getApplicationContext()).update();
} else {
···
}
}
if (savedState != null) {
···
} else {
if (!mIsShowingDashboard) {
···
} else {
//展示主面板
mDisplayHomeAsUpEnabled = false;
mDisplaySearch = true;
mInitialTitleResId = R.string.dashboard_title;
//切换加载 Fragment
switchToFragment(DashboardSummary.class.getName(), null, false, false,
mInitialTitleResId, mInitialTitle, false);
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
由于mIsShowingDashboard是true的原因，代码执行了上面的这段代码。即执行了 switchToFragment() 方法
switchToFragment(DashboardSummary.class.getName(), null /* args */, false, false,
mInitialTitleResId, mInitialTitle, false);
1
2
switchToFragment 又加载的 DashboardSummary，即切换到 DashboardSummary 这个 Fragment，switchToFragment 代码如下
private Fragment switchToFragment(String fragmentName, Bundle args, boolean validate,
boolean addToBackStack, int titleResId, CharSequence title, boolean withTransition) {
···
Fragment f = Fragment.instantiate(this, fragmentName, args);
FragmentTransaction transaction = getFragmentManager().beginTransaction();
//将fragment加载在控件ID为main_content的位置
transaction.replace(R.id.main_content, f);
···
transaction.commitAllowingStateLoss();
getFragmentManager().executePendingTransactions();
return f;
}
1
2
3
4
5
6
7
8
9
10
11
12
接下来看DashboardSummary.java
具体路径为：/packages/apps/Settings/src/com/android/settings/dashboard/DashboardSummary.java 。其中 onCreateView 方法如下：
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,Bundle savedInstanceState) {
mLayoutInflater = inflater;
final View rootView = inflater.inflate(R.layout.dashboard, container, false);
mDashboard = (ViewGroup) rootView.findViewById(R.id.dashboard_container);
return rootView;
}
1
2
3
4
5
6
7
从代码中可以看出来，DashboardSummary这个Fragment加载的dashboard.xml这个布局文件,接下来看下dashboard.xml布局,
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/dashboard"
···
>
<LinearLayout
android:id="@+id/dashboard_container"
···
android:orientation="vertical"
/>
</ScrollView>
1
2
3
4
5
6
7
8
9
10
最外层是ScrollView，内层是LinearLayout，在上图中的setting界面中，最外层是可滑动的原因就在此，设置选项都是放在LinearLayout中的，并且是动态添加上去的。
接着看DashboardSummary.onResume()方法，发现它最终跑到rebuildUI(context)中，并在这里加载 UI，代码如下：
private void rebuildUI(Context context) {
···
final Resources res = getResources();
//mDashboard为dashboard.xml布局中的LinearLayout的id，此处先移除LinearLayout里的所有控件
mDashboard.removeAllViews();
//获取菜单选项
List<DashboardCategory> categories =
((SettingsActivity) context).getDashboardCategories(true);
···
}
1
2
3
4
5
6
7
8
9
10
那么接下来看看SettingsActivity.getDashboardCategories函数：
public List<DashboardCategory> getDashboardCategories(boolean forceRefresh) {
if (forceRefresh || mCategories.size() == 0) {
buildDashboardCategories(mCategories);
}
return mCategories;
}
1
2
3
4
5
6
private void buildDashboardCategories(List<DashboardCategory> categories) {
//先清空
categories.clear();
//加载dashboard_categories中的数据,解析xml，将解析好的数据资源存放到了List<DashboardCategory>这个集合中
loadCategoriesFromResource(R.xml.dashboard_categories, categories, this);
//更新categories到界面上，这里可以设置设置中某个categories（比如wifi、蓝牙设置）是否展示。
updateTilesList(categories);
}
1
2
3
4
5
6
7
8
到这里可以看出，该方法内部实现是解析dashboard_categories.xml文件，获取到所有的设置项的，所以6.0中Setting的显示内容的条目数量是由资源数量决定的，而这个资源就定义在dashboard_categories.xml中。
它的具体路径为：/packages/apps/Settings/res/xml/dashboard_categories.xml。所以getDashboardCategories会在显示UI之前会去加载资源，dashboard_categories.xml.代码如下：
<dashboard-categories
xmlns:android="http://schemas.android.com/apk/res/android">
<!-- WIRELESS and NETWORKS -->
<dashboard-category
android:id="@+id/wireless_section"
android:key="@string/category_key_wireless"
android:title="@string/header_category_wireless_networks" >
<!-- Wifi -->
<dashboard-tile
android:id="@+id/wifi_settings"
android:title="@string/wifi_settings_title"
android:fragment="com.android.settings.wifi.WifiSettings" android:icon="@drawable/ic_settings_wireless"
/>
<!-- Bluetooth -->
···
</dashboard-category>
···
</dashboard-categories>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
DashboardCategory的代码如下
文件路径为：/packages/apps/Settings/src/com/android/settings/dashboard/DashboardCategory.java
public class DashboardCategory implements Parcelable {
//{@link com.android.settings.dashboard.DashboardCategory#id DashboardCategory.id}
//的标识符为设置时他的默认值为-1. 所有其他值（包括低于-1的值）都有效
public static final long CAT_ID_UNDEFINED = -1;
// 为title设置一个id,当他更新时会和一个新的list关联，默认没有id。
public long id = CAT_ID_UNDEFINED;
//类别title的资源id.Resource ID of title of the category that is shown to the user.
public int titleRes;
//类别title.
public CharSequence title;
//设置额外的 title 时会用到.
public String key;
public int externalIndex = -1;
//类别下面的一系列子设置选项
public List<DashboardTile> tiles = new ArrayList<DashboardTile>();
public DashboardCategory() {
// Empty
}
···
@Override
public void writeToParcel(Parcel dest, int flags) {
···
}
public void readFromParcel(Parcel in) {
···
}
DashboardCategory(Parcel in) {
readFromParcel(in);
}
public static final Creator<DashboardCategory> CREATOR = new Creator<DashboardCategory>() {
public DashboardCategory createFromParcel(Parcel source) {
return new DashboardCategory(source);
}
public DashboardCategory[] newArray(int size) {
return new DashboardCategory[size];
}
};
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
其中dashboard_categories.xml的dashboard-category节点对应的是DashboardCategory的对象，dashboard-tile节点对应的是DashboardTile的对象，而DashboardCategory对象内部有List tiles的集合对象，所解析出来的DashboardTile都有DashboardCategory保管，而每个DashboardCategory对象又由categories来保管,就这样数据资源就得到了.
所以如果想要添加一个设置项，只需要在dashboard_categories.xml文件中添加一个控件，如果要删除一个设置项可以在 SettingsActivity中 的 updateTilesList 方法中将 removetile 设置为 true，然后移除。
接着来看rebuildUI的代码：
private void rebuildUI(Context context) {
···
final int count = categories.size();
for (int n = 0; n < count; n++) {
//每一个大类里设置项的数量
DashboardCategory category = categories.get(n);
//每一个设置项为自定义的dashboard-tile，其布局文件为dashboard_category.xml
View categoryView = mLayoutInflater.inflate(R.layout.dashboard_category, mDashboard,
false);
TextView categoryLabel = (TextView) categoryView.findViewById(R.id.category_title);
categoryLabel.setText(category.getTitle(res));
ViewGroup categoryContent =
(ViewGroup) categoryView.findViewById(R.id.category_content);
final int tilesCount = category.getTilesCount();
for (int i = 0; i < tilesCount; i++) {
DashboardTile tile = category.getTile(i);
//dashboard_categories.xml的dashboard-category节点最终对应了DashboardTileView的对象
DashboardTileView tileView = new DashboardTileView(context);
updateTileView(context, res, tile, tileView.getImageView(),
tileView.getTitleTextView(), tileView.getStatusTextView());
tileView.setTile(tile);
categoryContent.addView(tileView);
}
// 添加一个类别
mDashboard.addView(categoryView);
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
可以看出rebuildUI接下来的代码便是循环遍历添加数据显示的过程。
其中 dashboard_category.xml （注意不是 dashboard_categories.xml ）代码如下，代码路径为 ：/packages/apps/Settings/res/layout/dashboard_category.xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/category"
android:orientation="vertical"
android:background="@color/card_background"
···
>
<TextView android:id="@+id/category_title"
···
/>
<com.android.settings.dashboard.DashboardContainerView
android:id="@+id/category_content"
android:layout_width="match_parent"
android:layout_height="wrap_content"
/>
</LinearLayout>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
所以如果想要修改所有设置项的布局，可以修改 dashboard_category.xml 文件
那么 DashboardTileView 和 dashboard-category 到底是如何跳转到具体的某个Fragment呢？来看看 DashboardTileView，代码路径为：/packages/apps/Settings/src/com/android/settings/dashboard/DashboardTileView.java
@Override
public void onClick(View v) {
if (mTile.fragment != null) {
Utils.startWithFragment(getContext(), mTile.fragment, mTile.fragmentArguments, null, 0,mTile.titleRes, mTile.getTitle(getResources()));
} else if (mTile.intent != null) {
int numUserHandles = mTile.userHandle.size();
if (numUserHandles > 1) {
ProfileSelectDialog.show(((Activity) getContext()).getFragmentManager(), mTile);
} else if (numUserHandles == 1) {
getContext().startActivityAsUser(mTile.intent, mTile.userHandle.get(0));
} else {
getContext().startActivity(mTile.intent);
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
所以当点击 DashboardTileView 的某个对象时就会跳转至一个具体的 Fragment，而这个 Fragment 已经在 dashboard-category 节点中声明。
小结
跟踪源码到最后，我们会发现 6.0 的设置菜单加载是通过读取 xml 文件完成的，整个过程浑然天成，不禁让人感叹 google 架构的厉害。。
---------------------
作者：一个人的世界ll
来源：CSDN
原文：https://blog.csdn.net/qq_29117915/article/details/83042759
版权声明：本文为博主原创文章，转载请附上博文链接！
5204
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
