// Copyright 2017 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

package io.flutter.app;

import android.content.ComponentCallbacks2;
import android.content.Intent;
import android.os.Bundle;
import io.flutter.plugin.common.PluginRegistry.ActivityResultListener;
import io.flutter.plugin.common.PluginRegistry.RequestPermissionResultListener;

/**
 * A collection of Android {@code Activity} methods that are relevant to the
 * core operation of Flutter applications.
 * <p/>
 * Application authors that use an activity other than {@link FlutterActivity}
 * should forward all events herein from their activity to an instance of
 * {@link FlutterActivityDelegate} in order to wire the activity up to the
 * Flutter framework. This forwarding is already provided in
 * {@code FlutterActivity}.
 */
public interface FlutterActivityEvents
        extends ComponentCallbacks2, ActivityResultListener, RequestPermissionResultListener {
    /**
     * @see android.app.Activity#onCreate(android.os.Bundle)
     */
    void onCreate(Bundle savedInstanceState);

    /**
     * @see android.app.Activity#onNewIntent(Intent)
     */
    void onNewIntent(Intent intent);

    /**
     * @see android.app.Activity#onPause()
     */
    void onPause();

    /**
     * @see android.app.Activity#onResume()
     */
    void onResume();

    /**
     * @see android.app.Activity#onPostResume()
     */
    void onPostResume();

    /**
     * @see android.app.Activity#onDestroy()
     */
    void onDestroy();

    /**
     * Invoked when the activity has detected the user's press of the back key.
     *
     * @return {@code true} if the listener handled the event; {@code false}
     *     to let the activity continue with its default back button handling.
     * @see android.app.Activity#onBackPressed()
     */
    boolean onBackPressed();

    /**
     * @see android.app.Activity#onUserLeaveHint()
     */
    void onUserLeaveHint();
}