blob: 5387be83920e5333edc0469fd2efd85d25d158b4 [file] [log] [blame]
/*
* 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<WidgetAddFlowHandler> CREATOR =
new Parcelable.Creator<WidgetAddFlowHandler>() {
public WidgetAddFlowHandler createFromParcel(Parcel source) {
return new WidgetAddFlowHandler(source);
}
public WidgetAddFlowHandler[] newArray(int size) {
return new WidgetAddFlowHandler[size];
}
};
}