文章詳情頁

分析Android 11.0Settings源碼之主界面加載

瀏覽：96日期：2022-09-19 15:18:58

本篇主要記錄AndroidR Settings源碼主界面加載流程，方便后續(xù)工作調(diào)試其流程。

Settings代碼路徑：

packages/app/Settings/

Settings代碼獲取：

Setting 源碼下載地址：https://github.com/aosp-mirror/platform_packages_apps_settingsgit地址：https://github.com/aosp-mirror/platform_packages_apps_settings.git

主界面加載：

首先我們來看 Settings 模塊中的 AndroidManifest.xml 文件，找到默認(rèn)啟動(dòng)入口Activity信息：

<activity android:name='.homepage.SettingsHomepageActivity' android:label='@string/settings_label_launcher' android:theme='@style/Theme.Settings.Home' android:taskAffinity='com.android.settings.root' android:launchMode='singleTask' android:configChanges='keyboard|keyboardHidden'><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可用來設(shè)置某個(gè)Activity的快捷入口，可以放在桌面上或者通過該別名被其他組件快速調(diào)起。 //android:targetActivity為目標(biāo)Activity. <activity-alias android:name='Settings' android:label='@string/settings_label_launcher' android:taskAffinity='com.android.settings.root' android:launchMode='singleTask' android:targetActivity='.homepage.SettingsHomepageActivity'><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><meta-data android:name='android.app.shortcuts' android:resource='@xml/shortcuts'/></activity-alias>

可以看到Settings的桌面圖標(biāo)啟動(dòng)的主界面是Settings.java，但其xml定義了targetActivity屬性，實(shí)質(zhì)應(yīng)是SettingsHomepageActivity.java，從onCreate()方法開始:

@Overrideprotected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.settings_homepage_container); final View root = findViewById(R.id.settings_homepage_container); root.setSystemUiVisibility( View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION | View.SYSTEM_UI_FLAG_LAYOUT_STABLE); setHomepageContainerPaddingTop(); final Toolbar toolbar = findViewById(R.id.search_action_bar); FeatureFactory.getFactory(this).getSearchFeatureProvider() .initSearchToolbar(this /* activity */, toolbar, SettingsEnums.SETTINGS_HOMEPAGE); final ImageView avatarView = findViewById(R.id.account_avatar); getLifecycle().addObserver(new AvatarViewMixin(this, avatarView)); getLifecycle().addObserver(new HideNonSystemOverlayMixin(this)); if (!getSystemService(ActivityManager.class).isLowRamDevice()) {// Only allow contextual feature on high ram devices.showFragment(new ContextualCardsFragment(), R.id.contextual_cards_content); } showFragment(new TopLevelSettings(), R.id.main_content); ((FrameLayout) findViewById(R.id.main_content)) .getLayoutTransition().enableTransitionType(LayoutTransition.CHANGING);}

可以看到主界面的layout為settings_homepage_container.xml:

<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android='http://schemas.android.com/apk/res/android' xmlns:app='http://schemas.android.com/apk/res-auto' android: android:fitsSystemWindows='true' android:layout_width='match_parent' android:layout_height='match_parent'> <androidx.core.widget.NestedScrollViewandroid: android:layout_width='match_parent'android:layout_height='match_parent'app:layout_behavior='com.android.settings.widget.FloatingAppBarScrollingViewBehavior'><LinearLayout android: android:layout_width='match_parent' android:layout_height='wrap_content' android:orientation='vertical'> <FrameLayoutandroid: android:layout_width='match_parent'android:layout_height='wrap_content'android:layout_marginStart='@dimen/contextual_card_side_margin'android:layout_marginEnd='@dimen/contextual_card_side_margin'/> <FrameLayoutandroid: android:layout_width='match_parent'android:layout_height='wrap_content'android:animateLayoutChanges='true'android:background='?android:attr/windowBackground'/></LinearLayout> </androidx.core.widget.NestedScrollView> <com.google.android.material.appbar.AppBarLayoutandroid:layout_width='match_parent'android:layout_height='wrap_content'android:touchscreenBlocksFocus='false'android:keyboardNavigationCluster='false'><include layout='@layout/search_bar'/> </com.google.android.material.appbar.AppBarLayout></androidx.coordinatorlayout.widget.CoordinatorLayout>

主界面布局中主要包含兩部分：一個(gè)頂部快捷搜索欄，一個(gè)Id為main_content的FrameLayout就是用來顯示主設(shè)置內(nèi)容的，即Settings的一級(jí)菜單項(xiàng)界面。回到onCreate()方法：

showFragment(new TopLevelSettings(), R.id.main_content);

可以看到一級(jí)菜單啟動(dòng)的是TopLevelSettings，TopLevelSettings繼承于DashboardFragment.java：

public class TopLevelSettings extends DashboardFragment implementsPreferenceFragmentCompat.OnPreferenceStartFragmentCallback

TopLevelSettings的構(gòu)造方法：

public TopLevelSettings() { final Bundle args = new Bundle(); // Disable the search icon because this page uses a full search view in actionbar. args.putBoolean(NEED_SEARCH_ICON_IN_ACTION_BAR, false); setArguments(args);}

可以看到通過構(gòu)造方法傳遞了一個(gè)參數(shù)，從注釋中可以看出，該參數(shù)的用意是由于主界面使用完整的搜索視圖所以在主界面的actionbar中隱藏了搜索圖標(biāo)。然后再根據(jù)framgments生命周期先來看onAttach()方法:

@Overridepublic void onAttach(Context context) { super.onAttach(context); use(SupportPreferenceController.class).setActivity(getActivity());}

調(diào)用父類DashboardFragment.java的onAttach()方法：

@Overridepublic void onAttach(Context context) { super.onAttach(context); mSuppressInjectedTileKeys = Arrays.asList(context.getResources().getStringArray( R.array.config_suppress_injected_tile_keys)); mDashboardFeatureProvider = FeatureFactory.getFactory(context). getDashboardFeatureProvider(context); // Load preference controllers from code final List<AbstractPreferenceController> controllersFromCode = createPreferenceControllers(context); // Load preference controllers from xml definition final List<BasePreferenceController> controllersFromXml = PreferenceControllerListHelper .getPreferenceControllersFromXml(context, getPreferenceScreenResId()); // Filter xml-based controllers in case a similar controller is created from code already. final List<BasePreferenceController> uniqueControllerFromXml = PreferenceControllerListHelper.filterControllers( controllersFromXml, controllersFromCode); // Add unique controllers to list. if (controllersFromCode != null) {mControllers.addAll(controllersFromCode); } mControllers.addAll(uniqueControllerFromXml); // And wire up with lifecycle. final Lifecycle lifecycle = getSettingsLifecycle(); uniqueControllerFromXml.forEach(controller -> {if (controller instanceof LifecycleObserver) { lifecycle.addObserver((LifecycleObserver) controller);} }); // Set metrics category for BasePreferenceController. final int metricCategory = getMetricsCategory(); mControllers.forEach(controller -> {if (controller instanceof BasePreferenceController) { ((BasePreferenceController) controller).setMetricsCategory(metricCategory);} }); mPlaceholderPreferenceController = new DashboardTilePlaceholderPreferenceController(context); mControllers.add(mPlaceholderPreferenceController); for (AbstractPreferenceController controller : mControllers) {addPreferenceController(controller); }}

通過方法注釋可以得知此方法主要是完成preference controllers的加載。DashboardFragment.java的onCreate()方法：

@Overridepublic void onCreate(Bundle icicle) { super.onCreate(icicle); // Set ComparisonCallback so we get better animation when list changes. getPreferenceManager().setPreferenceComparisonCallback( new PreferenceManager.SimplePreferenceComparisonCallback()); if (icicle != null) {// Upon rotation configuration change we need to update preference states before any// editing dialog is recreated (that would happen before onResume is called).updatePreferenceStates(); }}

設(shè)置ComparisonCallback，以便在列表更改時(shí)獲得更好的動(dòng)畫效果。第一次進(jìn)入時(shí)，icicle為null，根據(jù)log定位發(fā)現(xiàn)，其后調(diào)用DashboardFragment.java的onCreatePreferences()方法：

@Overridepublic void onCreatePreferences(Bundle savedInstanceState, String rootKey) { checkUiBlocker(mControllers); refreshAllPreferences(getLogTag()); mControllers.stream() .map(controller -> (Preference) findPreference(controller.getPreferenceKey())) .filter(Objects::nonNull) .forEach(preference -> {// Give all controllers a chance to handle click.preference.getExtras().putInt(CATEGORY, getMetricsCategory()); });}

調(diào)用refreshAllPreferences()：

/** * Refresh all preference items, including both static prefs from xml, and dynamic items from * DashboardCategory. */private void refreshAllPreferences(final String tag) { final PreferenceScreen screen = getPreferenceScreen(); // First remove old preferences. if (screen != null) {// Intentionally do not cache PreferenceScreen because it will be recreated later.screen.removeAll(); } // Add resource based tiles. displayResourceTiles(); refreshDashboardTiles(tag); final Activity activity = getActivity(); if (activity != null) {Log.d(tag, 'All preferences added, reporting fully drawn');activity.reportFullyDrawn(); } updatePreferenceVisibility(mPreferenceControllers);}

刷新所有preference items，包括來自xml的靜態(tài)preference和來自DashboardCategory的動(dòng)態(tài)preference，靜態(tài)xml定義的prefs(調(diào)用displayResourceTiles()方法)，動(dòng)態(tài)DashboardCategory動(dòng)態(tài)加載(調(diào)用refreshDashboardTiles(TAG)方法，其中TAG為 “TopLevelSettings”)。displayResourceTiles()：此方法主要是從xml資源文件中加載顯示prefs：

/** * Displays resource based tiles. */private void displayResourceTiles() { final int resId = getPreferenceScreenResId(); if (resId <= 0) {return; } addPreferencesFromResource(resId); final PreferenceScreen screen = getPreferenceScreen(); screen.setOnExpandButtonClickListener(this); displayResourceTilesToScreen(screen);}/** * Perform {@link AbstractPreferenceController#displayPreference(PreferenceScreen)} * on all {@link AbstractPreferenceController}s. */protected void displayResourceTilesToScreen(PreferenceScreen screen) { mPreferenceControllers.values().stream().flatMap(Collection::stream).forEach( controller -> controller.displayPreference(screen));}靜態(tài)加載

首先調(diào)用getPreferenceScreenResId()方法獲取所要加載的xml的ID，然后調(diào)用子類TopLevelSettings.java的getPreferenceScreenResId()方法：

@Overrideprotected int getPreferenceScreenResId() { return R.xml.top_level_settings;}

可以看到Settings主界面加載的xml文件是top_level_settings：

可以看到主要配置的是一些Preference菜單項(xiàng)如網(wǎng)絡(luò)和互聯(lián)網(wǎng)、已連接的設(shè)備、應(yīng)用和通知、電池等等，Preference的配置含義：

key：唯一性ID； title：標(biāo)題； summary：簡(jiǎn)介； ico：圖標(biāo)； order：加載顯示優(yōu)先級(jí)，order為負(fù)時(shí)，絕對(duì)值越高，界面顯示越靠前；order為正時(shí)，值越高，顯示越靠后； fragment：點(diǎn)擊此preference所跳轉(zhuǎn)的fragment界面； controller：控制管理類。動(dòng)態(tài)加載

refreshDashboardTiles

總結(jié)： Settings的主Activity實(shí)質(zhì)實(shí)現(xiàn)是在SettingsHomepageActivity.java內(nèi)； Settings的主界面設(shè)置item的顯示是在fragment上，fragment為TopLevelSettings.java，加載顯示的布局為top_level_settings.xml； Settings主界面設(shè)置項(xiàng)item的加載顯示主要分為兩部分，一部分是xml定義的靜態(tài)加載，xml為top_level_settings.xml；一部分是DashboardCategory來獲取動(dòng)態(tài)加載；每個(gè)設(shè)置項(xiàng)item均為一個(gè)preference，通過xml定義加載時(shí)，必須要有一個(gè)controller，可以是在xml中定義'settings:controller'屬性聲明，名稱必須與類的包名路徑相同；也可直接在相關(guān)fragment中實(shí)現(xiàn)createPreferenceControllers()方法去調(diào)用構(gòu)造相關(guān)controller。此二者存其一即可。 xml中配置preference時(shí)，必須定義”android:key“屬性；

以上就是分析Android 11.0Settings源碼之主界面加載的詳細(xì)內(nèi)容，更多關(guān)于Android 11.0Settings源碼的資料請(qǐng)關(guān)注好吧啦網(wǎng)其它相關(guān)文章！

Android

上一條：如何使用Android注解處理器下一條：詳解Android文件描述符

相關(guān)文章：

1. Vue 實(shí)現(xiàn)對(duì)quill-editor組件中的工具欄添加title2. 使用Python webdriver圖書館搶座自動(dòng)預(yù)約的正確方法3. 在線php代碼縮進(jìn)、代碼美化工具：PHP Formatter4. ASP.NET MVC使用jQuery ui的progressbar實(shí)現(xiàn)進(jìn)度條5. Python 合并拼接字符串的方法6. Linux刪除系統(tǒng)自帶版本Python過程詳解7. Python3 json模塊之編碼解碼方法講解8. Python字符串到字節(jié)的轉(zhuǎn)換。雙反斜杠問題9. Android 簡(jiǎn)單的實(shí)現(xiàn)滑塊拼圖驗(yàn)證碼功能10. ASP基礎(chǔ)知識(shí)VBScript基本元素講解

排行榜

					
					使用Python webdriver圖書館搶座自動(dòng)預(yù)約的正確方法
Vue 實(shí)現(xiàn)對(duì)quill-editor組件中的工具欄添加title
Android 簡(jiǎn)單的實(shí)現(xiàn)滑塊拼圖驗(yàn)證碼功能
ASP.NET MVC使用jQuery ui的progressbar實(shí)現(xiàn)進(jìn)度條
淺談django不使用restframework自定義接口與使用的區(qū)別
樹型結(jié)構(gòu)列出指定目錄里所有文件的PHP類
Linux刪除系統(tǒng)自帶版本Python過程詳解
ASP基礎(chǔ)知識(shí)VBScript基本元素講解
Python字符串到字節(jié)的轉(zhuǎn)換。雙反斜杠問題
Python 合并拼接字符串的方法
Android Studio實(shí)現(xiàn)格式化XML代碼順序
				