services/core/java/com/android/server/timezone/PackageTrackerIntentHelper.java

/*
 * 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.server.timezone;

/**
 * An easy-to-mock interface around intent sending / receiving for use by {@link PackageTracker};
 * it is not possible to test various cases with the real one because of the need to simulate
 * receiving and broadcasting intents.
 */
interface PackageTrackerIntentHelper {

    void initialize(String updateAppPackageName, String dataAppPackageName,
            PackageTracker packageTracker);

    void sendTriggerUpdateCheck(CheckToken checkToken);

    /**
     * Schedule a "reliability trigger" after at least minimumDelayMillis, replacing any existing
     * scheduled one. A reliability trigger ensures that the {@link PackageTracker} can pick up
     * reliably if a previous update check did not complete for some reason. It can happen when
     * the device is idle. The trigger is expected to call
     * {@link PackageTracker#triggerUpdateIfNeeded(boolean)} with a {@code false} value.
     */
    void scheduleReliabilityTrigger(long minimumDelayMillis);

    /**
     * Make sure there is no reliability trigger scheduled. No-op if there wasn't one.
     */
    void unscheduleReliabilityTrigger();
}