devbox
羊村懒王
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

AppWidget启动流程部分 Launcher分析_startappwidgetconfigureactivityforresult怎么使用

作者：羊村懒王 | 2024-03-25 23:18:33

赞

踩

startappwidgetconfigureactivityforresult怎么使用

基于源代码: Android2.2. Launcher.java.


操作流程：在Launcher界面长按,选择“窗口小部件”，弹出小部件选择框，选择自己的小部件，出现Configure Activity,点击OK,显示Widget.










启动流程：Laucher界面 

-------->Launcher.onLongClick() { ....           showAddDialog(cellInfo)               .......}  

Launcher.showAddDialog(){ .........  showDialog(DIALOG_CREATE_SHORTCUT); .........}  

 ----->Activity.showDialog(,){ .............     createDialog() ;   onPrepareDialog()    ........................}

------->Launcher.onCreateDialog(){ .....................    new CreateShortcut().createDialog();  .........................}   //显示 "添加到主屏幕" ; 

Launcher.onPrepareDialog(){ ....                                    .............} 

-------> Laucher.CreateShortcut.onClick() { ..........    

 case AddAdapter.ITEM_APPWIDGET: {
                    int appWidgetId = Launcher.this.mAppWidgetHost.allocateAppWidgetId(); //分配WIdgetId,不能自己设置

 Intent pickIntent = new Intent(AppWidgetManager.ACTION_APPWIDGET_PICK);
                    pickIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
                    // start the pick activity
                    startActivityForResult(pickIntent, REQUEST_PICK_APPWIDGET);//加载"选择窗口小部件"activity
                     break;   }

             ......}


       ---------> "选择窗口小部件"activity,选择了某一个AppWidget, onClick(),AppWidgetManager.bindAppWidgetId(),AppWidgetService.bindAppWidgetId()

appWidgetService.bindAppWidgetId(){  ...........

//发送Enable BroadCast,then AppWidgetProvider get broadcast ,执行onEnale();

//发送Update BroadCast,then AppWidgetProvider get broadcast ,执行onUpdate();

............

}


  ---------->Launcher.onActivityResult(){       .............     


  case REQUEST_PICK_APPWIDGET:
                    addAppWidget(data);
                    break;

      ..................  }


-------->Launcher.addAppWidget(){ ....................

//当需要Configure时，打开ConfigureActivity,同时将AppWidgetId传入

 if (appWidget.configure != null) {
            // Launch over to configure widget, if needed
            Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_CONFIGURE);
            intent.setComponent(appWidget.configure);
            intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
            startActivityForResultSafely(intent, REQUEST_CREATE_APPWIDGET);    //

}else{

 // Otherwise just add it
            onActivityResult(REQUEST_CREATE_APPWIDGET, Activity.RESULT_OK, data);

}

.....................}


主要流程：

1.Createshortcut Dialog  [添加到主屏幕]  

2.AppWidgetPickActivity [ 选择小部件 ]

3.发送Broadcast

A> AppWidgetManager.sService 发送widgetID的ACTION_APPWIDGET_ENABLED【Sent when an instance of an AppWidget is added to a host for the first time】，widgetID的OnEnabled被called；

B>AppWidgetManager.sService 发送widgetID的ACTION_APPWIDGET_UPDATE，widgetID的OnUpdated被called；

C>返回Launcher, 发送ACTION_APPWIDGET_CONFIGURE，configureActivity将收到此广播，并打开自己的activity，对widget的参数进行配置【配置的参数采用SharedPreferences方式，widget跟host可以共享访问

4.添加Widget


另外： 

D>删除插件时，即在插件上长按，在拖动到垃圾桶里，会调用ACTION_APPWIDGET_DELETED【Sent when an instance of an AppWidget is deleted from its host】，这里可以做一些清除工作，比如清除配置信息，停止alarm等操作；

E>如果app只绑定了一个插件的话，则appwidgetmanager.sService会发送ACTION_APPWIDGET_DISABLED【Sent when an instance of an AppWidget is removed from the last host】，同样可以做一些清理的工作。

（2）下一次手机开机

由于插件已经绑定过了，并且configure过了，此时启动后，appwidgetmanager会执行A> B>,不会执行C>，所以第一次安装过程中，最好是对参数做一个合理的配置。不过一般来讲，widget上还有配置的选项，在运行后可以再次设置



源代码：

1.Launcher.OnLongClick

  1.   public boolean onLongClick(View v) {
  2.         switch (v.getId()) {
  3.             case R.id.previous_screen:
  4.                 if (!isAllAppsVisible()) {
  5.                     mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
  6.                             HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
  7.                     showPreviews(v);
  8.                 }
  9.                 return true;
  10.             case R.id.next_screen:
  11.                 if (!isAllAppsVisible()) {
  12.                     mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
  13.                             HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
  14.                     showPreviews(v);
  15.                 }
  16.                 return true;
  17.             case R.id.all_apps_button:
  18.                 if (!isAllAppsVisible()) {
  19.                     mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
  20.                             HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
  21.                     showPreviews(v);
  22.                 }
  23.                 return true;
  24.         }
  25.  
  26.         if (isWorkspaceLocked()) {
  27.             return false;
  28.         }
  29.  
  30.         if (!(v instanceof CellLayout)) {
  31.             v = (View) v.getParent();
  32.         }
  33.  
  34.         CellLayout.CellInfo cellInfo = (CellLayout.CellInfo) v.getTag();
  35.  
  36.         // This happens when long clicking an item with the dpad/trackball
  37.         if (cellInfo == null) {
  38.             return true;
  39.         }
  40.  
  41.         if (mWorkspace.allowLongPress()) {
  42.             if (cellInfo.cell == null) {
  43.                 if (cellInfo.valid) {
  44.                     // User long pressed on empty space
  45.                     mWorkspace.setAllowLongPress(false);
  46.                     mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
  47.                             HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
  48.                     showAddDialog(cellInfo);
  49.                 }
  50.             } else {
  51.                 if (!(cellInfo.cell instanceof Folder)) {
  52.                     // User long pressed on an item
  53.                     mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS,
  54.                             HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING);
  55.                     mWorkspace.startDrag(cellInfo);
  56.                 }
  57.             }
  58.         }
  59.         return true;
  60.     }



2. Activity.showDialog();


  1.     /**
  2.      * Simple version of {@link #showDialog(int, Bundle)} that does not
  3.      * take any arguments.  Simply calls {@link #showDialog(int, Bundle)}
  4.      * with null arguments.
  5.      */
  6.     public final void showDialog(int id) {
  7.         showDialog(id, null);
  8.     }
  9.  
  10.     /**
  11.      * Show a dialog managed by this activity.  A call to {@link #onCreateDialog(int, Bundle)}
  12.      * will be made with the same id the first time this is called for a given
  13.      * id.  From thereafter, the dialog will be automatically saved and restored.
  14.      *
  15.      * <p>Each time a dialog is shown, {@link #onPrepareDialog(int, Dialog, Bundle)} will
  16.      * be made to provide an opportunity to do any timely preparation.
  17.      *
  18.      * @param id The id of the managed dialog.
  19.      * @param args Arguments to pass through to the dialog.  These will be saved
  20.      * and restored for you.  Note that if the dialog is already created,
  21.      * {@link #onCreateDialog(int, Bundle)} will not be called with the new
  22.      * arguments but {@link #onPrepareDialog(int, Dialog, Bundle)} will be.
  23.      * If you need to rebuild the dialog, call {@link #removeDialog(int)} first.
  24.      * @return Returns true if the Dialog was created; false is returned if
  25.      * it is not created because {@link #onCreateDialog(int, Bundle)} returns false.
  26.      * 
  27.      * @see Dialog
  28.      * @see #onCreateDialog(int, Bundle)
  29.      * @see #onPrepareDialog(int, Dialog, Bundle)
  30.      * @see #dismissDialog(int)
  31.      * @see #removeDialog(int)
  32.      */
  33.     public final boolean showDialog(int id, Bundle args) {
  34.         if (mManagedDialogs == null) {
  35.             mManagedDialogs = new SparseArray<ManagedDialog>();
  36.         }
  37.         ManagedDialog md = mManagedDialogs.get(id);
  38.         if (md == null) {
  39.             md = new ManagedDialog();
  40.             md.mDialog = createDialog(id, null, args);
  41.             if (md.mDialog == null) {
  42.                 return false;
  43.             }
  44.             mManagedDialogs.put(id, md);
  45.         }
  46.         
  47.         md.mArgs = args;
  48.         onPrepareDialog(id, md.mDialog, args);
  49.         md.mDialog.show();
  50.         return true;
  51.     }


3.CreateShortcut Dialog.其内容有mAddAdapter,就是"添加到主屏幕"的Dialog，点击"窗口小部件"，将启动“选择窗口小部件”的  AppWidgetPickActivity。 
  1.  private class CreateShortcut implements DialogInterface.OnClickListener,
  2.             DialogInterface.OnCancelListener, DialogInterface.OnDismissListener,
  3.             DialogInterface.OnShowListener {
  4.  
  5.         private AddAdapter mAdapter;
  6.  
  7.         Dialog createDialog() {
  8.             mAdapter = new AddAdapter(Launcher.this);
  9.  
  10.             final AlertDialog.Builder builder = new AlertDialog.Builder(Launcher.this);
  11.             builder.setTitle(getString(R.string.menu_item_add_item));
  12.             builder.setAdapter(mAdapter, this);
  13.  
  14.             builder.setInverseBackgroundForced(true);
  15.  
  16.             AlertDialog dialog = builder.create();
  17.             dialog.setOnCancelListener(this);
  18.             dialog.setOnDismissListener(this);
  19.             dialog.setOnShowListener(this);
  20.  
  21.             return dialog;
  22.         }
  23.  
  24.         public void onCancel(DialogInterface dialog) {
  25.             mWaitingForResult = false;
  26.             cleanup();
  27.         }
  28.  
  29.         public void onDismiss(DialogInterface dialog) {
  30.         }
  31.  
  32.         private void cleanup() {
  33.             try {
  34.                 dismissDialog(DIALOG_CREATE_SHORTCUT);
  35.             } catch (Exception e) {
  36.                 // An exception is thrown if the dialog is not visible, which is fine
  37.             }
  38.         }
  39.  
  40.         /**
  41.          * Handle the action clicked in the "Add to home" dialog.
  42.          */
  43.         public void onClick(DialogInterface dialog, int which) {
  44.             Resources res = getResources();
  45.             cleanup();
  46.  
  47.             switch (which) {
  48.                 case AddAdapter.ITEM_SHORTCUT: {
  49.                     // Insert extra item to handle picking application
  50.                     pickShortcut();
  51.                     break;
  52.                 }
  53.  
  54.                 case AddAdapter.ITEM_APPWIDGET: {
  55.                     int appWidgetId = Launcher.this.mAppWidgetHost.allocateAppWidgetId();
  56.  
  57.                     Intent pickIntent = new Intent(AppWidgetManager.ACTION_APPWIDGET_PICK);
  58.                     pickIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
  59.                     // start the pick activity
  60.                     startActivityForResult(pickIntent, REQUEST_PICK_APPWIDGET);
  61.                     break;
  62.                 }
  63.  
  64.                 case AddAdapter.ITEM_LIVE_FOLDER: {
  65.                     // Insert extra item to handle inserting folder
  66.                     Bundle bundle = new Bundle();
  67.  
  68.                     ArrayList<String> shortcutNames = new ArrayList<String>();
  69.                     shortcutNames.add(res.getString(R.string.group_folder));
  70.                     bundle.putStringArrayList(Intent.EXTRA_SHORTCUT_NAME, shortcutNames);
  71.  
  72.                     ArrayList<ShortcutIconResource> shortcutIcons =
  73.                             new ArrayList<ShortcutIconResource>();
  74.                     shortcutIcons.add(ShortcutIconResource.fromContext(Launcher.this,
  75.                             R.drawable.ic_launcher_folder));
  76.                     bundle.putParcelableArrayList(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, shortcutIcons);
  77.  
  78.                     Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY);
  79.                     pickIntent.putExtra(Intent.EXTRA_INTENT,
  80.                             new Intent(LiveFolders.ACTION_CREATE_LIVE_FOLDER));
  81.                     pickIntent.putExtra(Intent.EXTRA_TITLE,
  82.                             getText(R.string.title_select_live_folder));
  83.                     pickIntent.putExtras(bundle);
  84.  
  85.                     startActivityForResult(pickIntent, REQUEST_PICK_LIVE_FOLDER);
  86.                     break;
  87.                 }
  88.  
  89.                 case AddAdapter.ITEM_WALLPAPER: {
  90.                     startWallpaper();
  91.                     break;
  92.                 }
  93.             }
  94.         }
  95.  
  96.         public void onShow(DialogInterface dialog) {
  97.             mWaitingForResult = true;            
  98.         }
  99.     }


4.在AppWidgetPickerActivity中，内容为List<PickAdapter.Item> items,存放的是所有的widget。点击onClick,intent.getExtras() == null的,执行

mAppWidgetManager.bindAppWidgetId(mAppWidgetId, intent.getComponent());


启动AppWidgetService,并sService.bindAppWidgetId(){. .. ..},并发送Enable broadcast, Update broadcast; 

 AppWidgetProvider onReceive() Broadcast,执行 onEnable(),onUpdate()


  1.  public void onClick(DialogInterface dialog, int which) {
  2.         Intent intent = getIntentForPosition(which);
  3.         
  4.         int result;
  5.         if (intent.getExtras() != null) {
  6.             // If there are any extras, it's because this entry is custom.
  7.             // Don't try to bind it, just pass it back to the app.
  8.             setResultData(RESULT_OK, intent);
  9.         } else {
  10.             try {
  11.                 mAppWidgetManager.bindAppWidgetId(mAppWidgetId, intent.getComponent());
  12.                 result = RESULT_OK;
  13.             } catch (IllegalArgumentException e) {
  14.                 // This is thrown if they're already bound, or otherwise somehow
  15.                 // bogus.  Set the result to canceled, and exit.  The app *should*
  16.                 // clean up at this point.  We could pass the error along, but
  17.                 // it's not clear that that's useful -- the widget will simply not
  18.                 // appear.
  19.                 result = RESULT_CANCELED;
  20.             }
  21.             setResultData(result, null);
  22.         }
  23.         finish();
  24.     }

AppWidgetService.bindAppWidgetId 

  1.  public void bindAppWidgetId(int appWidgetId, ComponentName provider) {
  2.         mContext.enforceCallingPermission(android.Manifest.permission.BIND_APPWIDGET,
  3.                 "bindGagetId appWidgetId=" + appWidgetId + " provider=" + provider);
  4.         synchronized (mAppWidgetIds) {
  5.             AppWidgetId id = lookupAppWidgetIdLocked(appWidgetId);
  6.             if (id == null) {
  7.                 throw new IllegalArgumentException("bad appWidgetId");
  8.             }
  9.             if (id.provider != null) {
  10.                 throw new IllegalArgumentException("appWidgetId " + appWidgetId + " already bound to "
  11.                         + id.provider.info.provider);
  12.             }
  13.             Provider p = lookupProviderLocked(provider);
  14.             if (p == null) {
  15.                 throw new IllegalArgumentException("not a appwidget provider: " + provider);
  16.             }
  17.             if (p.zombie) {
  18.                 throw new IllegalArgumentException("can't bind to a 3rd party provider in"
  19.                         + " safe mode: " + provider);
  20.             }
  21.  
  22.             id.provider = p;
  23.             p.instances.add(id);
  24.             int instancesSize = p.instances.size();
  25.             if (instancesSize == 1) {
  26.                 // tell the provider that it's ready
  27.                 sendEnableIntentLocked(p);
  28.             }
  29.  
  30.             // send an update now -- We need this update now, and just for this appWidgetId.
  31.             // It's less critical when the next one happens, so when we schdule the next one,
  32.             // we add updatePeriodMillis to its start time.  That time will have some slop,
  33.             // but that's okay.
  34.             sendUpdateIntentLocked(p, new int[] { appWidgetId });
  35.  
  36.             // schedule the future updates
  37.             registerForBroadcastsLocked(p, getAppWidgetIds(p));
  38.             saveStateLocked();
  39.         }
  40.     }


5. 从"选择窗口小部件"Activity中返回选择的小部件REQUEST_PICK_APPWIDGET


  1.   @Override
  2.     protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  3.         mWaitingForResult = false;
  4.  
  5.         // The pattern used here is that a user PICKs a specific application,
  6.         // which, depending on the target, might need to CREATE the actual target.
  7.  
  8.         // For example, the user would PICK_SHORTCUT for "Music playlist", and we
  9.         // launch over to the Music app to actually CREATE_SHORTCUT.
  10.  
  11.         if (resultCode == RESULT_OK && mAddItemCellInfo != null) {
  12.             switch (requestCode) {
  13.                 case REQUEST_PICK_APPLICATION:
  14.                     completeAddApplication(this, data, mAddItemCellInfo);
  15.                     break;
  16.                 case REQUEST_PICK_SHORTCUT:
  17.                     processShortcut(data);
  18.                     break;
  19.                 case REQUEST_CREATE_SHORTCUT:
  20.                     completeAddShortcut(data, mAddItemCellInfo);
  21.                     break;
  22.                 case REQUEST_PICK_LIVE_FOLDER:
  23.                     addLiveFolder(data);
  24.                     break;
  25.                 case REQUEST_CREATE_LIVE_FOLDER:
  26.                     completeAddLiveFolder(data, mAddItemCellInfo);
  27.                     break;
  28.                 case REQUEST_PICK_APPWIDGET:
  29.                     addAppWidget(data);
  30.                     break;
  31.                 case REQUEST_CREATE_APPWIDGET:
  32.                     completeAddAppWidget(data, mAddItemCellInfo);
  33.                     break;
  34.                 case REQUEST_PICK_WALLPAPER:
  35.                     // We just wanted the activity result here so we can clear mWaitingForResult
  36.                     break;
  37.             }
  38.         } else if ((requestCode == REQUEST_PICK_APPWIDGET ||
  39.                 requestCode == REQUEST_CREATE_APPWIDGET) && resultCode == RESULT_CANCELED &&
  40.                 data != null) {
  41.             // Clean up the appWidgetId if we canceled
  42.             int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);
  43.             if (appWidgetId != -1) {
  44.                 mAppWidgetHost.deleteAppWidgetId(appWidgetId);
  45.             }
  46.         }
  47.     }


6.添加Widget,当有ConfugureActivity的时候，就启动ConfigureActivity,否则直接加载AppWidget 
  1.  void addAppWidget(Intent data) {
  2.         // TODO: catch bad widget exception when sent
  3.         int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);
  4.         AppWidgetProviderInfo appWidget = mAppWidgetManager.getAppWidgetInfo(appWidgetId);
  5.  
  6.         if (appWidget.configure != null) {
  7.             // Launch over to configure widget, if needed
  8.             Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_CONFIGURE);
  9.             intent.setComponent(appWidget.configure);
  10.             intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
  11.  
  12.             startActivityForResultSafely(intent, REQUEST_CREATE_APPWIDGET);
  13.         } else {
  14.             // Otherwise just add it
  15.             onActivityResult(REQUEST_CREATE_APPWIDGET, Activity.RESULT_OK, data);
  16.         }
  17.     }
7.当发送REQUEST_CREATE_APPWIDGET时，completeAddAppWidget() 
  1.   /**
  2.      * Add a widget to the workspace.
  3.      *
  4.      * @param data The intent describing the appWidgetId.
  5.      * @param cellInfo The position on screen where to create the widget.
  6.      */
  7.     private void completeAddAppWidget(Intent data, CellLayout.CellInfo cellInfo) {
  8.         Bundle extras = data.getExtras();
  9.         int appWidgetId = extras.getInt(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);
  10.  
  11.         if (LOGD) Log.d(TAG, "dumping extras content=" + extras.toString());
  12.  
  13.         AppWidgetProviderInfo appWidgetInfo = mAppWidgetManager.getAppWidgetInfo(appWidgetId);
  14.  
  15.         // Calculate the grid spans needed to fit this widget
  16.         CellLayout layout = (CellLayout) mWorkspace.getChildAt(cellInfo.screen);
  17.         int[] spans = layout.rectToCell(appWidgetInfo.minWidth, appWidgetInfo.minHeight);
  18.  
  19.         // Try finding open space on Launcher screen
  20.         final int[] xy = mCellCoordinates;
  21.         if (!findSlot(cellInfo, xy, spans[0], spans[1])) {
  22.             if (appWidgetId != -1) mAppWidgetHost.deleteAppWidgetId(appWidgetId);
  23.             return;
  24.         }
  25.  
  26.         // Build Launcher-specific widget info and save to database
  27.         LauncherAppWidgetInfo launcherInfo = new LauncherAppWidgetInfo(appWidgetId);
  28.         launcherInfo.spanX = spans[0];
  29.         launcherInfo.spanY = spans[1];
  30.  
  31.         LauncherModel.addItemToDatabase(this, launcherInfo,
  32.                 LauncherSettings.Favorites.CONTAINER_DESKTOP,
  33.                 mWorkspace.getCurrentScreen(), xy[0], xy[1], false);
  34.  
  35.         if (!mRestoring) {
  36.             mDesktopItems.add(launcherInfo);
  37.  
  38.             // Perform actual inflation because we're live
  39.             launcherInfo.hostView = mAppWidgetHost.createView(this, appWidgetId, appWidgetInfo);
  40.  
  41.             launcherInfo.hostView.setAppWidget(appWidgetId, appWidgetInfo);
  42.             launcherInfo.hostView.setTag(launcherInfo);
  43.  
  44.             mWorkspace.addInCurrentScreen(launcherInfo.hostView, xy[0], xy[1],
  45.                     launcherInfo.spanX, launcherInfo.spanY, isWorkspaceLocked());
  46.         }
  47.     }



声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/羊村懒王/article/detail/313040
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号