/*
 * Copyright (C) 2016 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.settings.applications;

import android.app.Fragment;
import android.content.Intent;
import android.view.View;

import java.util.Set;

public interface ApplicationFeatureProvider {

    /**
     * Returns a new {@link AppHeaderController} instance to customize app header.
     */
    AppHeaderController newAppHeaderController(Fragment fragment, View appHeader);

    /**
     * Count all installed packages, irrespective of install reason.
     */
    public static final int IGNORE_INSTALL_REASON = -1;

    /**
     * Calculates the total number of apps installed on the device, across all users and managed
     * profiles.
     *
     * @param installReason Only consider apps with this install reason; may be any install reason
     *         defined in {@link android.content.pm.PackageManager} or
     *         {@link #IGNORE_INSTALL_REASON} to count all apps, irrespective of install reason.
     * @param async Whether to count asynchronously in a background thread
     * @param callback The callback to invoke with the result
     */
    void calculateNumberOfInstalledApps(int installReason, boolean async,
            NumberOfAppsCallback callback);

    /**
     * Asynchronously calculates the total number of apps installed on the device, across all users
     * and managed profiles, that have been granted one or more of the given permissions by the
     * admin.
     *
     * @param permissions Only consider apps that have been granted one or more of these permissions
     *        by the admin, either at run-time or install-time
     * @param callback The callback to invoke with the result
     */
    void calculateNumberOfAppsWithAdminGrantedPermissions(String[] permissions,
            NumberOfAppsCallback callback);

    /**
     * Return the persistent preferred activities configured by the admin for the current user and
     * all its managed profiles. A persistent preferred activity is an activity that the admin
     * configured to always handle a given intent (e.g. open browser), even if the user has other
     * apps installed that would also be able to handle the intent.
     *
     * @param intent The intents for which to find persistent preferred activities
     *
     * @return the persistent preferred activites for the given intent
     */
    Set<PersistentPreferredActivityInfo> findPersistentPreferredActivities(Intent[] intents);

    /**
     * Callback that receives the number of packages installed on the device.
     */
    interface NumberOfAppsCallback {
        void onNumberOfAppsResult(int num);
    }

    public static class PersistentPreferredActivityInfo {
        public final String packageName;
        public final int userId;

        public PersistentPreferredActivityInfo(String packageName, int userId) {
            this.packageName = packageName;
            this.userId = userId;
        }

        @Override
        public boolean equals(Object other) {
            if (!(other instanceof PersistentPreferredActivityInfo)) {
                return false;
            }
            final PersistentPreferredActivityInfo otherActivityInfo
                    = (PersistentPreferredActivityInfo) other;
            return otherActivityInfo.packageName.equals(packageName)
                    && otherActivityInfo.userId == userId;
        }

        @Override
        public int hashCode() {
            return packageName.hashCode() ^ userId;
        }
    }
}