/* * Copyright (C) 2017 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.launcher3.widget; import android.appwidget.AppWidgetProviderInfo; import android.content.Context; import android.os.Parcel; import android.os.Parcelable; import com.android.launcher3.ItemInfo; import com.android.launcher3.Launcher; import com.android.launcher3.LauncherAppWidgetInfo; import com.android.launcher3.LauncherAppWidgetProviderInfo; import com.android.launcher3.util.PendingRequestArgs; /** * Utility class to handle app widget add flow. */ public class WidgetAddFlowHandler implements Parcelable { private final AppWidgetProviderInfo mProviderInfo; public WidgetAddFlowHandler(AppWidgetProviderInfo providerInfo) { mProviderInfo = providerInfo; } protected WidgetAddFlowHandler(Parcel parcel) { mProviderInfo = AppWidgetProviderInfo.CREATOR.createFromParcel(parcel); } @Override public int describeContents() { return 0; } @Override public void writeToParcel(Parcel parcel, int i) { mProviderInfo.writeToParcel(parcel, i); } public void startBindFlow(Launcher launcher, int appWidgetId, ItemInfo info, int requestCode) { launcher.setWaitingForResult(PendingRequestArgs.forWidgetInfo(appWidgetId, this, info)); launcher.getAppWidgetHost() .startBindFlow(launcher, appWidgetId, mProviderInfo, requestCode); } /** * @see #startConfigActivity(Launcher, int, ItemInfo, int) */ public boolean startConfigActivity(Launcher launcher, LauncherAppWidgetInfo info, int requestCode) { return startConfigActivity(launcher, info.appWidgetId, info, requestCode); } /** * Starts the widget configuration flow if needed. * @return true if the configuration flow was started, false otherwise. */ public boolean startConfigActivity(Launcher launcher, int appWidgetId, ItemInfo info, int requestCode) { if (!needsConfigure()) { return false; } launcher.setWaitingForResult(PendingRequestArgs.forWidgetInfo(appWidgetId, this, info)); launcher.getAppWidgetHost().startConfigActivity(launcher, appWidgetId, requestCode); return true; } public boolean needsConfigure() { return mProviderInfo.configure != null; } public LauncherAppWidgetProviderInfo getProviderInfo(Context context) { return LauncherAppWidgetProviderInfo.fromProviderInfo(context, mProviderInfo); } public static final Parcelable.Creator CREATOR = new Parcelable.Creator() { public WidgetAddFlowHandler createFromParcel(Parcel source) { return new WidgetAddFlowHandler(source); } public WidgetAddFlowHandler[] newArray(int size) { return new WidgetAddFlowHandler[size]; } }; }