Most visited

Recently visited

Results for

Added in API level 9

NativeActivity

public class NativeActivity
extends Activity implements SurfaceHolder.Callback2, InputQueue.Callback, ViewTreeObserver.OnGlobalLayoutListener

java.lang.Object
	android.content.Context
		android.content.ContextWrapper
			android.view.ContextThemeWrapper
				android.app.Activity
					android.app.NativeActivity

方便实施纯粹以本地代码实施的活动。也就是说，一款游戏（或类似游戏的东西）。没有必要从这个类中派生出来; 你可以简单地在清单中声明它，并从那里使用NDK API。

典型的清单看起来像：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.native_activity"
        android:versionCode="1"
        android:versionName="1.0">

    <!-- This is the platform API where NativeActivity was introduced. -->
    <uses-sdk android:minSdkVersion="9" />

    <!-- This .apk has no Java code itself, so set hasCode to false. -->
    <application android:label="@string/app_name" android:hasCode="false">

        <!-- Our activity is the built-in NativeActivity framework class.
             This will take care of integrating with our NDK code. -->
        <activity android:name="android.app.NativeActivity"
                android:label="@string/app_name"
                android:configChanges="orientation|keyboardHidden">
            <!-- Tell NativeActivity the name of or .so -->
            <meta-data android:name="android.app.lib_name"
                    android:value="native-activity" />
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

NativeActivity运行的一个非常简单的本机代码示例如下。这会从用户那里读取输入事件，并使用OpenGLES绘制到本地活动的窗口。

#include <jni.h>
#include <errno.h>

#include <EGL/egl.h>
#include <GLES/gl.h>

#include <android/sensor.h>
#include <android/log.h>
#include <android_native_app_glue.h>

#define LOGI(...) ((void)__android_log_print(ANDROID_LOG_INFO, "native-activity", __VA_ARGS__))
#define LOGW(...) ((void)__android_log_print(ANDROID_LOG_WARN, "native-activity", __VA_ARGS__))

/**
 * Our saved state data.
 */
struct saved_state {
    float angle;
    int32_t x;
    int32_t y;
};

/**
 * Shared state for our app.
 */
struct engine {
    struct android_app* app;

    ASensorManager* sensorManager;
    const ASensor* accelerometerSensor;
    ASensorEventQueue* sensorEventQueue;

    int animating;
    EGLDisplay display;
    EGLSurface surface;
    EGLContext context;
    int32_t width;
    int32_t height;
    struct saved_state state;
};

/**
 * Initialize an EGL context for the current display.
 */
static int engine_init_display(struct engine* engine) {
    // initialize OpenGL ES and EGL

    /*
     * Here specify the attributes of the desired configuration.
     * Below, we select an EGLConfig with at least 8 bits per color
     * component compatible with on-screen windows
     */
    const EGLint attribs[] = {
            EGL_SURFACE_TYPE, EGL_WINDOW_BIT,
            EGL_BLUE_SIZE, 8,
            EGL_GREEN_SIZE, 8,
            EGL_RED_SIZE, 8,
            EGL_NONE
    };
    EGLint w, h, dummy, format;
    EGLint numConfigs;
    EGLConfig config;
    EGLSurface surface;
    EGLContext context;

    EGLDisplay display = eglGetDisplay(EGL_DEFAULT_DISPLAY);

    eglInitialize(display, 0, 0);

    /* Here, the application chooses the configuration it desires. In this
     * sample, we have a very simplified selection process, where we pick
     * the first EGLConfig that matches our criteria */
    eglChooseConfig(display, attribs, &config, 1, &numConfigs);

    /* EGL_NATIVE_VISUAL_ID is an attribute of the EGLConfig that is
     * guaranteed to be accepted by ANativeWindow_setBuffersGeometry().
     * As soon as we picked a EGLConfig, we can safely reconfigure the
     * ANativeWindow buffers to match, using EGL_NATIVE_VISUAL_ID. */
    eglGetConfigAttrib(display, config, EGL_NATIVE_VISUAL_ID, &format);

    ANativeWindow_setBuffersGeometry(engine->app->window, 0, 0, format);

    surface = eglCreateWindowSurface(display, config, engine->app->window, NULL);
    context = eglCreateContext(display, config, NULL, NULL);

    if (eglMakeCurrent(display, surface, surface, context) == EGL_FALSE) {
        LOGW("Unable to eglMakeCurrent");
        return -1;
    }

    eglQuerySurface(display, surface, EGL_WIDTH, &w);
    eglQuerySurface(display, surface, EGL_HEIGHT, &h);

    engine->display = display;
    engine->context = context;
    engine->surface = surface;
    engine->width = w;
    engine->height = h;
    engine->state.angle = 0;

    // Initialize GL state.
    glHint(GL_PERSPECTIVE_CORRECTION_HINT, GL_FASTEST);
    glEnable(GL_CULL_FACE);
    glShadeModel(GL_SMOOTH);
    glDisable(GL_DEPTH_TEST);

    return 0;
}

/**
 * Just the current frame in the display.
 */
static void engine_draw_frame(struct engine* engine) {
    if (engine->display == NULL) {
        // No display.
        return;
    }

    // Just fill the screen with a color.
    glClearColor(((float)engine->state.x)/engine->width, engine->state.angle,
            ((float)engine->state.y)/engine->height, 1);
    glClear(GL_COLOR_BUFFER_BIT);

    eglSwapBuffers(engine->display, engine->surface);
}

/**
 * Tear down the EGL context currently associated with the display.
 */
static void engine_term_display(struct engine* engine) {
    if (engine->display != EGL_NO_DISPLAY) {
        eglMakeCurrent(engine->display, EGL_NO_SURFACE, EGL_NO_SURFACE, EGL_NO_CONTEXT);
        if (engine->context != EGL_NO_CONTEXT) {
            eglDestroyContext(engine->display, engine->context);
        }
        if (engine->surface != EGL_NO_SURFACE) {
            eglDestroySurface(engine->display, engine->surface);
        }
        eglTerminate(engine->display);
    }
    engine->animating = 0;
    engine->display = EGL_NO_DISPLAY;
    engine->context = EGL_NO_CONTEXT;
    engine->surface = EGL_NO_SURFACE;
}

/**
 * Process the next input event.
 */
static int32_t engine_handle_input(struct android_app* app, AInputEvent* event) {
    struct engine* engine = (struct engine*)app->userData;
    if (AInputEvent_getType(event) == AINPUT_EVENT_TYPE_MOTION) {
        engine->animating = 1;
        engine->state.x = AMotionEvent_getX(event, 0);
        engine->state.y = AMotionEvent_getY(event, 0);
        return 1;
    }
    return 0;
}

/**
 * Process the next main command.
 */
static void engine_handle_cmd(struct android_app* app, int32_t cmd) {
    struct engine* engine = (struct engine*)app->userData;
    switch (cmd) {
        case APP_CMD_SAVE_STATE:
            // The system has asked us to save our current state.  Do so.
            engine->app->savedState = malloc(sizeof(struct saved_state));
            *((struct saved_state*)engine->app->savedState) = engine->state;
            engine->app->savedStateSize = sizeof(struct saved_state);
            break;
        case APP_CMD_INIT_WINDOW:
            // The window is being shown, get it ready.
            if (engine->app->window != NULL) {
                engine_init_display(engine);
                engine_draw_frame(engine);
            }
            break;
        case APP_CMD_TERM_WINDOW:
            // The window is being hidden or closed, clean it up.
            engine_term_display(engine);
            break;
        case APP_CMD_GAINED_FOCUS:
            // When our app gains focus, we start monitoring the accelerometer.
            if (engine->accelerometerSensor != NULL) {
                ASensorEventQueue_enableSensor(engine->sensorEventQueue,
                        engine->accelerometerSensor);
                // We'd like to get 60 events per second (in us).
                ASensorEventQueue_setEventRate(engine->sensorEventQueue,
                        engine->accelerometerSensor, (1000L/60)*1000);
            }
            break;
        case APP_CMD_LOST_FOCUS:
            // When our app loses focus, we stop monitoring the accelerometer.
            // This is to avoid consuming battery while not being used.
            if (engine->accelerometerSensor != NULL) {
                ASensorEventQueue_disableSensor(engine->sensorEventQueue,
                        engine->accelerometerSensor);
            }
            // Also stop animating.
            engine->animating = 0;
            engine_draw_frame(engine);
            break;
    }
}

/**
 * This is the main entry point of a native application that is using
 * android_native_app_glue.  It runs in its own thread, with its own
 * event loop for receiving input events and doing other things.
 */
void android_main(struct android_app* state) {
    struct engine engine;

    // Make sure glue isn't stripped.
    app_dummy();

    memset(&engine, 0, sizeof(engine));
    state->userData = &engine;
    state->onAppCmd = engine_handle_cmd;
    state->onInputEvent = engine_handle_input;
    engine.app = state;

    // Prepare to monitor accelerometer
    engine.sensorManager = ASensorManager_getInstance();
    engine.accelerometerSensor = ASensorManager_getDefaultSensor(engine.sensorManager,
            ASENSOR_TYPE_ACCELEROMETER);
    engine.sensorEventQueue = ASensorManager_createEventQueue(engine.sensorManager,
            state->looper, LOOPER_ID_USER, NULL, NULL);

    if (state->savedState != NULL) {
        // We are starting with a previous saved state; restore from it.
        engine.state = *(struct saved_state*)state->savedState;
    }

    // loop waiting for stuff to do.

    while (1) {
        // Read all pending events.
        int ident;
        int events;
        struct android_poll_source* source;

        // If not animating, we will block forever waiting for events.
        // If animating, we loop until all events are read, then continue
        // to draw the next frame of animation.
        while ((ident=ALooper_pollAll(engine.animating ? 0 : -1, NULL, &events,
                (void**)&source)) >= 0) {

            // Process this event.
            if (source != NULL) {
                source->process(state, source);
            }

            // If a sensor has data, process it now.
            if (ident == LOOPER_ID_USER) {
                if (engine.accelerometerSensor != NULL) {
                    ASensorEvent event;
                    while (ASensorEventQueue_getEvents(engine.sensorEventQueue,
                            &event, 1) > 0) {
                        LOGI("accelerometer: x=%f y=%f z=%f",
                                event.acceleration.x, event.acceleration.y,
                                event.acceleration.z);
                    }
                }
            }

            // Check if we are exiting.
            if (state->destroyRequested != 0) {
                engine_term_display(&engine);
                return;
            }
        }

        if (engine.animating) {
            // Done with events; draw next animation frame.
            engine.state.angle += .01f;
            if (engine.state.angle > 1) {
                engine.state.angle = 0;
            }

            // Drawing is throttled to the screen update rate, so there
            // is no need to do timing here.
            engine_draw_frame(&engine);
        }
    }
}

摘要(Summary)

常量(Constants)
`String`	`META_DATA_FUNC_NAME` 可选元 - 可以在此组件的清单中，指定 `META_DATA_LIB_NAME`本机代码中此本机活动的主入口点的名称。
`String`	`META_DATA_LIB_NAME` 可选元 - 可以在此组件的清单中，指定要加载的本机共享库的名称。

Inherited constants

From class android.app.Activity

From class android.content.Context

From interface android.content.ComponentCallbacks2

Inherited fields

From class android.app.Activity

Public constructors
`NativeActivity()`

公共方法(Public methods)
`void`	`onConfigurationChanged(Configuration newConfig)` 设备配置在您的活动正在运行时更改时由系统调用。
`void`	`onGlobalLayout()` 当全局布局状态或视图树中视图的可见性发生更改时调用回调方法
`void`	`onInputQueueCreated(InputQueue queue)` 当给定的InputQueue现在与进行此调用的线程相关联时调用，因此它可以开始接收来自它的事件。
`void`	`onInputQueueDestroyed(InputQueue queue)` 当给定的InputQueue不再与该线程关联并因此不调度事件时调用。
`void`	`onLowMemory()` 这在整个系统内存不足时调用，并且主动运行的进程应该修剪内存使用情况。
`void`	`onWindowFocusChanged(boolean hasFocus)` 当活动当前 `Window`获得或失去焦点时调用。
`void`	`surfaceChanged(SurfaceHolder holder, int format, int width, int height)` 这是在对表面进行任何结构更改（格式或大小）后立即调用的。
`void`	`surfaceCreated(SurfaceHolder holder)` 这是在表面首次创建后立即调用的。
`void`	`surfaceDestroyed(SurfaceHolder holder)` 这是在表面被破坏之前立即调用的。
`void`	`surfaceRedrawNeeded(SurfaceHolder holder)` 当应用程序需要重新绘制其表面的内容，调整大小或出于某种其他原因时调用。

Protected methods
`void`	`onCreate(Bundle savedInstanceState)` 当活动开始时调用。
`void`	`onDestroy()` 在活动销毁之前执行任何最终清理。
`void`	`onPause()` 作为活动生命周期的一部分，当活动进入后台但尚未（尚未）死亡时调用。
`void`	`onResume()` 后调用 `onRestoreInstanceState(Bundle)` ， `onRestart()` ，或 `onPause()` ，为您的活动启动与用户交互。
`void`	`onSaveInstanceState(Bundle outState)` 被调用以在被杀死之前从活动中检索每个实例的状态，以便可以在 `onCreate(Bundle)`或 `onRestoreInstanceState(Bundle)`恢复状态（由该方法填充的 `Bundle`将被传递给两者）。
`void`	`onStart()` 在 `onCreate(Bundle)`之后或在 `onRestart()`之后 `onRestart()`活动已停止但现在再次显示给用户时调用。
`void`	`onStop()` 当用户不再可见时调用。

继承方法(Inherited methods)

From class android.app.Activity

From class android.view.ContextThemeWrapper

From class android.content.ContextWrapper

`void`	`attachBaseContext(Context base)` 为此ContextWrapper设置基本上下文。
`boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` 连接到应用程序服务，根据需要创建它。
`int`	`checkCallingOrSelfPermission(String permission)` 确定IPC的调用过程还是您已被授予特定权限。
`int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` 确定IPC的调用进程或您是否被授予访问特定URI的权限。
`int`	`checkCallingPermission(String permission)` 确定您正在处理的IPC的调用进程是否已被授予特定权限。
`int`	`checkCallingUriPermission(Uri uri, int modeFlags)` 确定调用进程和用户标识是否已被授予访问特定URI的权限。
`int`	`checkPermission(String permission, int pid, int uid)` 确定是否允许给定的权限用于系统中运行的特定进程和用户标识。
`int`	`checkSelfPermission(String permission)` 确定您是否已获得特定权限。
`int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` 检查Uri和普通权限。
`int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` 确定是否已授予特定进程和用户标识访问特定URI的权限。
`void`	`clearWallpaper()` 此方法在API级别23中已弃用。请改为使用`WallpaperManager.clear()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`Context`	`createConfigurationContext(Configuration overrideConfiguration)` 为当前上下文返回一个新的Context对象，但其资源被调整以匹配给定的配置。
`Context`	`createDeviceProtectedStorageContext()` 为当前上下文返回一个新的Context对象，但其存储API由受设备保护的存储支持。
`Context`	`createDisplayContext(Display display)` 为当前上下文返回一个新的Context对象，但其资源被调整为匹配给定Display的指标。
`Context`	`createPackageContext(String packageName, int flags)` 为给定的应用程序名称返回一个新的Context对象。
`String[]`	`databaseList()` 返回一个字符串数组，命名与此Context的应用程序包关联的专用数据库。
`boolean`	`deleteDatabase(String name)` 删除与此Context的应用程序包关联的现有私有SQLiteDatabase。
`boolean`	`deleteFile(String name)` 删除与此Context的应用程序包关联的给定私人文件。
`boolean`	`deleteSharedPreferences(String name)` 删除现有的共享首选项文件。
`void`	`enforceCallingOrSelfPermission(String permission, String message)` 如果您和您正在处理的IPC的调用进程都没有被授予特定权限，则抛出 `SecurityException` 。
`void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` 如果IPC的调用进程或您未被授予访问特定URI的权限，则抛出 `SecurityException` 。
`void`	`enforceCallingPermission(String permission, String message)` 如果您正在处理的IPC的调用过程尚未获得特定许可，请抛出 `SecurityException` 。
`void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` 如果调用进程和用户标识没有被授予访问特定URI的权限，则抛出 `SecurityException` 。
`void`	`enforcePermission(String permission, int pid, int uid, String message)` 如果给定权限不允许用于系统中运行的特定进程和用户标识，则抛出 `SecurityException` 。
`void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` 强制执行Uri和普通权限。
`void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` 如果某个特定的进程和用户标识没有被授予访问特定URI的权限，则抛出 `SecurityException` 。
`String[]`	`fileList()` 返回一个字符串数组，命名与此Context的应用程序包关联的私有文件。
`Context`	`getApplicationContext()` 返回当前进程的单个全局应用程序对象的上下文。
`ApplicationInfo`	`getApplicationInfo()` 返回此上下文包的完整应用程序信息。
`AssetManager`	`getAssets()` 返回应用程序包的AssetManager实例。
`Context`	`getBaseContext()`
`File`	`getCacheDir()` 返回文件系统上特定于应用程序的缓存目录的绝对路径。
`ClassLoader`	`getClassLoader()` 返回一个你可以用来检索这个包中的类的类加载器。
`File`	`getCodeCacheDir()` 返回专用于存储缓存代码的文件系统上特定于应用程序的缓存目录的绝对路径。
`ContentResolver`	`getContentResolver()` 为你的应用程序包返回一个ContentResolver实例。
`File`	`getDataDir()` 返回存储属于此应用程序的所有私人文件的文件系统上目录的绝对路径。
`File`	`getDatabasePath(String name)` 返回存储使用 `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)`创建的数据库的文件系统上的绝对路径。
`File`	`getDir(String name, int mode)` 根据需要检索，创建应用程序可以放置自己的自定义数据文件的新目录。
`File`	`getExternalCacheDir()` 返回应用程序可以放置其拥有的缓存文件的主共享/外部存储设备上特定于应用程序的目录的绝对路径。
`File[]`	`getExternalCacheDirs()` 返回应用程序可以放置它拥有的缓存文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`File`	`getExternalFilesDir(String type)` 返回应用程序可以放置其拥有的持久性文件的主共享/外部存储设备上目录的绝对路径。
`File[]`	`getExternalFilesDirs(String type)` 返回应用程序可以放置其拥有的持久性文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`File[]`	`getExternalMediaDirs()` 返回应用程序可放置媒体文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`File`	`getFileStreamPath(String name)` 返回存储使用 `openFileOutput(String, int)`创建的文件的文件系统上的绝对路径。
`File`	`getFilesDir()` 返回存储使用 `openFileOutput(String, int)`创建的文件的文件系统上目录的绝对路径。
`Looper`	`getMainLooper()` 返回当前进程主线程的Looper。
`File`	`getNoBackupFilesDir()` 返回类似于 `getFilesDir()`的文件系统上目录的绝对路径。
`File`	`getObbDir()` 返回此应用程序的OBB文件（如果有）的主要共享/外部存储目录。
`File[]`	`getObbDirs()` 返回应用程序的OBB文件（如果有）的所有共享/外部存储设备上的应用程序特定目录的绝对路径。
`String`	`getPackageCodePath()` 返回此上下文的主要Android包的完整路径。
`PackageManager`	`getPackageManager()` 返回PackageManager实例以查找全局包信息。
`String`	`getPackageName()` 返回此应用程序包的名称。
`String`	`getPackageResourcePath()` 返回此上下文的主要Android包的完整路径。
`Resources`	`getResources()` 返回应用程序包的资源实例。
`SharedPreferences`	`getSharedPreferences(String name, int mode)` 检索并保存首选项文件'name'的内容，返回一个SharedPreferences，通过它可以检索和修改其值。
`Object`	`getSystemService(String name)` 按名称将句柄返回到系统级服务。
`String`	`getSystemServiceName(Class<?> serviceClass)` 获取由指定的类表示的系统级服务的名称。
`Resources.Theme`	`getTheme()` 返回与此上下文关联的主题对象。
`Drawable`	`getWallpaper()` 此方法在API级别23中已弃用。请改为使用`WallpaperManager.get()` 。
`int`	`getWallpaperDesiredMinimumHeight()` 此方法在API级别23中已弃用。请改为使用`WallpaperManager.getDesiredMinimumHeight()` 。
`int`	`getWallpaperDesiredMinimumWidth()` 此方法在API级别23中已弃用。请改为使用`WallpaperManager.getDesiredMinimumWidth()` 。
`void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` 无论该软件包是否具有访问Uri内容提供者的一般权限，都可以授予访问另一个软件包的特定Uri的权限。
`boolean`	`isDeviceProtectedStorage()` 指示此Context的存储API是否受设备保护存储支持。
`boolean`	`isRestricted()` 指示此上下文是否受限制。
`boolean`	`moveDatabaseFrom(Context sourceContext, String name)` 将现有数据库文件从给定的源存储上下文移动到此上下文。
`boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` 将现有的共享首选项文件从给定的源存储上下文移至此上下文。
`FileInputStream`	`openFileInput(String name)` 打开与此Context的应用程序包关联的私人文件以供阅读。
`FileOutputStream`	`openFileOutput(String name, int mode)` 打开与此Context的应用程序包关联的私有文件以进行写入。
`SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` 打开与此Context的应用程序包关联的新私有SQLiteDatabase。
`SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` 打开与此Context的应用程序包关联的新私有SQLiteDatabase。
`Drawable`	`peekWallpaper()` 此方法在API级别23中已弃用。请改为使用`WallpaperManager.peek()` 。
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` 注册BroadcastReceiver以在主要活动线程中运行。
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` 注册以接收意图广播，以在 `调度程序`的上下文中运行。
`void`	`removeStickyBroadcast(Intent intent)` 此方法在API级别23中已弃用。不应使用粘性广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` 此方法在API级别23中已弃用。不应使用粘性广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`void`	`revokeUriPermission(Uri uri, int modeFlags)` 删除所有权限以访问先前已添加 `grantUriPermission(String, Uri, int)`的特定内容提供商Uri。
`void`	`sendBroadcast(Intent intent, String receiverPermission)` 将给定的意图广播给所有感兴趣的BroadcastReceivers，允许强制执行可选的必需权限。
`void`	`sendBroadcast(Intent intent)` 将给定的意图广播给所有感兴趣的BroadcastReceivers。
`void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` 版本 `sendBroadcast(Intent)` ，允许您指定广播将被发送到的用户。
`void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` 版本 `sendBroadcast(Intent, String)` ，它允许您指定广播将被发送到的用户。
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 版本为 `sendBroadcast(Intent)` ，可让您从广播中接收数据。
`void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` 将给定的意图广播给所有感兴趣的BroadcastReceivers，一次发送一个，让更多的首选接收者在将广播发送给次优先接收者之前消费广播。
`void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 版本 `sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)` ，允许您指定广播将被发送到的用户。
`void`	`sendStickyBroadcast(Intent intent)` 此方法在API级别23中已弃用。不应使用粘性广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` 此方法在API级别23中已弃用。不应使用粘性广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 此方法在API级别23中已弃用。不应使用粘性广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 此方法在API级别23中已弃用。不应使用粘性广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`void`	`setTheme(int resid)` 为此上下文设置基本主题。
`void`	`setWallpaper(Bitmap bitmap)` 此方法在API级别23中已弃用。请改为使用`WallpaperManager.set()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`void`	`setWallpaper(InputStream data)` 此方法在API级别23中已弃用。请改为使用`WallpaperManager.set()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`void`	`startActivities(Intent[] intents, Bundle options)` 启动多项新活动。
`void`	`startActivities(Intent[] intents)` 与没有指定选项的 `startActivities(Intent[], Bundle)`相同。
`void`	`startActivity(Intent intent)` 与没有指定选项的 `startActivity(Intent, Bundle)`相同。
`void`	`startActivity(Intent intent, Bundle options)` 启动一项新活动。
`boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` 开始执行 `Instrumentation`类。
`void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` 与没有指定选项的 `startIntentSender(IntentSender, Intent, int, int, int, Bundle)`相同。
`void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` 像 `startActivity(Intent, Bundle)`一样，但需要启动一个IntentSender。
`ComponentName`	`startService(Intent service)` 请求启动给定的应用程序服务。
`boolean`	`stopService(Intent name)` 请求停止给定的应用程序服务。
`void`	`unbindService(ServiceConnection conn)` 断开应用程序服务。
`void`	`unregisterReceiver(BroadcastReceiver receiver)` 取消注册以前注册的BroadcastReceiver。

From class android.content.Context

`abstract boolean`	`bindService(Intent service, ServiceConnection conn, int flags)` 连接到应用程序服务，根据需要创建它。
`abstract int`	`checkCallingOrSelfPermission(String permission)` 确定IPC的调用过程还是您已被授予特定权限。
`abstract int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)` 确定IPC的调用进程或您是否被授予访问特定URI的权限。
`abstract int`	`checkCallingPermission(String permission)` 确定您正在处理的IPC的调用进程是否已被授予特定权限。
`abstract int`	`checkCallingUriPermission(Uri uri, int modeFlags)` 确定调用进程和用户标识是否已被授予访问特定URI的权限。
`abstract int`	`checkPermission(String permission, int pid, int uid)` 确定是否允许给定的权限用于系统中运行的特定进程和用户标识。
`abstract int`	`checkSelfPermission(String permission)` 确定您是否已获得特定权限。
`abstract int`	`checkUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags)` 检查Uri和普通权限。
`abstract int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)` 确定是否已授予特定进程和用户标识访问特定URI的权限。
`abstract void`	`clearWallpaper()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.clear()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`abstract Context`	`createConfigurationContext(Configuration overrideConfiguration)` 为当前上下文返回一个新的Context对象，但其资源被调整以匹配给定的配置。
`abstract Context`	`createDeviceProtectedStorageContext()` 为当前上下文返回一个新的Context对象，但其存储API由受设备保护的存储支持。
`abstract Context`	`createDisplayContext(Display display)` 为当前上下文返回一个新的Context对象，但其资源被调整为匹配给定Display的指标。
`abstract Context`	`createPackageContext(String packageName, int flags)` 为给定的应用程序名称返回一个新的Context对象。
`abstract String[]`	`databaseList()` 返回一个字符串数组，命名与此Context的应用程序包关联的专用数据库。
`abstract boolean`	`deleteDatabase(String name)` 删除与此Context的应用程序包关联的现有私有SQLiteDatabase。
`abstract boolean`	`deleteFile(String name)` 删除与此Context的应用程序包关联的给定私人文件。
`abstract boolean`	`deleteSharedPreferences(String name)` 删除现有的共享首选项文件。
`abstract void`	`enforceCallingOrSelfPermission(String permission, String message)` 如果你和你正在处理的IPC的调用过程都没有被授予特定的权限，则抛出 `SecurityException` 。
`abstract void`	`enforceCallingOrSelfUriPermission(Uri uri, int modeFlags, String message)` 如果IPC的调用进程或您未被授予访问特定URI的权限，则抛出 `SecurityException` 。
`abstract void`	`enforceCallingPermission(String permission, String message)` 如果您正在处理的IPC的调用过程尚未获得特定许可，请抛出 `SecurityException` 。
`abstract void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)` 如果调用进程和用户标识没有被授予访问特定URI的权限，则抛出 `SecurityException` 。
`abstract void`	`enforcePermission(String permission, int pid, int uid, String message)` 如果给定权限不允许用于系统中运行的特定进程和用户标识，则抛出 `SecurityException` 。
`abstract void`	`enforceUriPermission(Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message)` 强制执行Uri和普通权限。
`abstract void`	`enforceUriPermission(Uri uri, int pid, int uid, int modeFlags, String message)` 如果某个特定的进程和用户标识没有被授予访问特定URI的权限，则抛出 `SecurityException` 。
`abstract String[]`	`fileList()` 返回一个字符串数组，命名与此Context的应用程序包关联的私有文件。
`abstract Context`	`getApplicationContext()` 返回当前进程的单个全局应用程序对象的上下文。
`abstract ApplicationInfo`	`getApplicationInfo()` 返回此上下文包的完整应用程序信息。
`abstract AssetManager`	`getAssets()` 返回应用程序包的AssetManager实例。
`abstract File`	`getCacheDir()` 返回文件系统上特定于应用程序的缓存目录的绝对路径。
`abstract ClassLoader`	`getClassLoader()` 返回一个你可以用来检索这个包中的类的类加载器。
`abstract File`	`getCodeCacheDir()` 返回专用于存储缓存代码的文件系统上特定于应用程序的缓存目录的绝对路径。
`final int`	`getColor(int id)` 返回与特定资源ID关联的颜色并为当前主题设计样式。
`final ColorStateList`	`getColorStateList(int id)` 返回与特定资源ID关联的颜色状态列表，并为当前主题设计风格。
`abstract ContentResolver`	`getContentResolver()` 为你的应用程序包返回一个ContentResolver实例。
`abstract File`	`getDataDir()` 返回存储属于此应用程序的所有私人文件的文件系统上目录的绝对路径。
`abstract File`	`getDatabasePath(String name)` 返回存储使用 `openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)`创建的数据库的文件系统上的绝对路径。
`abstract File`	`getDir(String name, int mode)` 根据需要检索，创建应用程序可以放置自己的自定义数据文件的新目录。
`final Drawable`	`getDrawable(int id)` 返回与特定资源ID关联的可绘制对象，并为当前主题创建样式。
`abstract File`	`getExternalCacheDir()` 返回应用程序可以放置其拥有的缓存文件的主共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File[]`	`getExternalCacheDirs()` 返回应用程序可以放置它拥有的缓存文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File`	`getExternalFilesDir(String type)` 返回应用程序可以放置其拥有的持久性文件的主共享/外部存储设备上目录的绝对路径。
`abstract File[]`	`getExternalFilesDirs(String type)` 返回应用程序可以放置其拥有的持久性文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File[]`	`getExternalMediaDirs()` 返回应用程序可放置媒体文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。
`abstract File`	`getFileStreamPath(String name)` 返回存储使用 `openFileOutput(String, int)`创建的文件的文件系统上的绝对路径。
`abstract File`	`getFilesDir()` 返回存储使用 `openFileOutput(String, int)`创建的文件的文件系统上目录的绝对路径。
`abstract Looper`	`getMainLooper()` 返回当前进程主线程的Looper。
`abstract File`	`getNoBackupFilesDir()` 返回类似于 `getFilesDir()`的文件系统上目录的绝对路径。
`abstract File`	`getObbDir()` 返回此应用程序的OBB文件（如果有）的主要共享/外部存储目录。
`abstract File[]`	`getObbDirs()` 返回应用程序的OBB文件（如果有）的所有共享/外部存储设备上的应用程序特定目录的绝对路径。
`abstract String`	`getPackageCodePath()` 返回此上下文的主要Android包的完整路径。
`abstract PackageManager`	`getPackageManager()` 返回PackageManager实例以查找全局包信息。
`abstract String`	`getPackageName()` 返回此应用程序包的名称。
`abstract String`	`getPackageResourcePath()` 返回此上下文的主要Android包的完整路径。
`abstract Resources`	`getResources()` 返回应用程序包的资源实例。
`abstract SharedPreferences`	`getSharedPreferences(String name, int mode)` 检索并保存首选项文件'name'的内容，返回一个SharedPreferences，通过它可以检索和修改其值。
`final String`	`getString(int resId, Object... formatArgs)` 从应用程序包的默认字符串表中返回一个本地化的格式化字符串，替换 `Formatter`和 `format(String, Object...)`定义的格式参数。
`final String`	`getString(int resId)` 从应用程序包的默认字符串表中返回一个本地化的字符串。
`final <T> T`	`getSystemService(Class<T> serviceClass)` 按类返回句柄到系统级服务。
`abstract Object`	`getSystemService(String name)` 按名称将句柄返回到系统级服务。
`abstract String`	`getSystemServiceName(Class<?> serviceClass)` 获取由指定的类表示的系统级服务的名称。
`final CharSequence`	`getText(int resId)` 从应用程序包的默认字符串表中返回一个本地化的，风格化的CharSequence。
`abstract Resources.Theme`	`getTheme()` 返回与此上下文关联的主题对象。
`abstract Drawable`	`getWallpaper()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.get()` 。
`abstract int`	`getWallpaperDesiredMinimumHeight()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.getDesiredMinimumHeight()` 。
`abstract int`	`getWallpaperDesiredMinimumWidth()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.getDesiredMinimumWidth()` 。
`abstract void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)` 无论该软件包是否具有访问Uri内容提供者的一般权限，都可以授予访问另一个软件包的特定Uri的权限。
`abstract boolean`	`isDeviceProtectedStorage()` 指示此Context的存储API是否受设备保护存储支持。
`boolean`	`isRestricted()` 指示此上下文是否受限制。
`abstract boolean`	`moveDatabaseFrom(Context sourceContext, String name)` 将现有数据库文件从给定的源存储上下文移动到此上下文。
`abstract boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)` 将现有的共享首选项文件从给定的源存储上下文移至此上下文。
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs)` 在此Context的主题中检索样式化属性信息。
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs, int defStyleAttr, int defStyleRes)` 在此Context的主题中检索样式化属性信息。
`final TypedArray`	`obtainStyledAttributes(int resid, int[] attrs)` 在此Context的主题中检索样式化属性信息。
`final TypedArray`	`obtainStyledAttributes(int[] attrs)` 在此Context的主题中检索样式化属性信息。
`abstract FileInputStream`	`openFileInput(String name)` 打开与此Context的应用程序包关联的私人文件以供阅读。
`abstract FileOutputStream`	`openFileOutput(String name, int mode)` 打开与此Context的应用程序包关联的私有文件以进行写入。
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory, DatabaseErrorHandler errorHandler)` 打开与此Context的应用程序包关联的新私有SQLiteDatabase。
`abstract SQLiteDatabase`	`openOrCreateDatabase(String name, int mode, SQLiteDatabase.CursorFactory factory)` 打开与此Context的应用程序包关联的新私有SQLiteDatabase。
`abstract Drawable`	`peekWallpaper()` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.peek()` 。
`void`	`registerComponentCallbacks(ComponentCallbacks callback)` 将一个新的 `ComponentCallbacks`添加到Context的基本应用程序中，将在调用ComponentCallbacks活动方法和其他组件的同时调用该新应用程序。
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)` 注册BroadcastReceiver以在主要活动线程中运行。
`abstract Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter, String broadcastPermission, Handler scheduler)` 注册以接收意图广播，以在 `调度程序`的上下文中运行。
`abstract void`	`removeStickyBroadcast(Intent intent)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`revokeUriPermission(Uri uri, int modeFlags)` 删除所有权限，以访问之前添加了 `grantUriPermission(String, Uri, int)`的特定内容提供商Uri。
`abstract void`	`sendBroadcast(Intent intent, String receiverPermission)` 将给定的意图广播给所有感兴趣的BroadcastReceivers，允许强制执行可选的必需权限。
`abstract void`	`sendBroadcast(Intent intent)` 将给定的意图广播给所有感兴趣的BroadcastReceivers。
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user)` 版本 `sendBroadcast(Intent)` ，允许您指定广播将被发送到的用户。
`abstract void`	`sendBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission)` 版本 `sendBroadcast(Intent, String)` ，允许您指定广播将发送到的用户。
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 版本 `sendBroadcast(Intent)` ，允许您从广播接收数据。
`abstract void`	`sendOrderedBroadcast(Intent intent, String receiverPermission)` 将给定的意图广播给所有感兴趣的BroadcastReceivers，一次发送一个，让更多的首选接收者在将广播发送给次优先接收者之前消费广播。
`abstract void`	`sendOrderedBroadcastAsUser(Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 版本 `sendOrderedBroadcast(Intent, String, BroadcastReceiver, Handler, int, String, Bundle)` ，允许您指定广播将被发送到的用户。
`abstract void`	`sendStickyBroadcast(Intent intent)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`sendStickyOrderedBroadcast(Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`sendStickyOrderedBroadcastAsUser(Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras)` 此方法在API级别21中已弃用。不应使用粘滞广播。它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。
`abstract void`	`setTheme(int resid)` 为此上下文设置基本主题。
`abstract void`	`setWallpaper(Bitmap bitmap)` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.set()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`abstract void`	`setWallpaper(InputStream data)` 此方法在API级别5中已弃用。请改为使用`WallpaperManager.set()` 。此方法要求调用方拥有权限`SET_WALLPAPER` 。
`abstract void`	`startActivities(Intent[] intents, Bundle options)` 启动多项新活动。
`abstract void`	`startActivities(Intent[] intents)` 与没有指定选项的 `startActivities(Intent[], Bundle)`相同。
`abstract void`	`startActivity(Intent intent)` 与没有指定选项的 `startActivity(Intent, Bundle)`相同。
`abstract void`	`startActivity(Intent intent, Bundle options)` 启动一项新活动。
`abstract boolean`	`startInstrumentation(ComponentName className, String profileFile, Bundle arguments)` 开始执行一个 `Instrumentation`类。
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags)` 与没有指定选项的 `startIntentSender(IntentSender, Intent, int, int, int, Bundle)`相同。
`abstract void`	`startIntentSender(IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options)` 像 `startActivity(Intent, Bundle)`一样，但需要启动一个IntentSender。
`abstract ComponentName`	`startService(Intent service)` 请求启动给定的应用程序服务。
`abstract boolean`	`stopService(Intent service)` 请求停止给定的应用程序服务。
`abstract void`	`unbindService(ServiceConnection conn)` 断开应用程序服务。
`void`	`unregisterComponentCallbacks(ComponentCallbacks callback)` 删除先前在 `registerComponentCallbacks(ComponentCallbacks)`注册的 `ComponentCallbacks`对象。
`abstract void`	`unregisterReceiver(BroadcastReceiver receiver)` 取消注册以前注册的BroadcastReceiver。

From class java.lang.Object

From interface android.view.LayoutInflater.Factory2

From interface android.view.Window.Callback

From interface android.view.KeyEvent.Callback

From interface android.view.View.OnCreateContextMenuListener

From interface android.content.ComponentCallbacks2

From interface android.view.SurfaceHolder.Callback2

From interface android.view.InputQueue.Callback

From interface android.view.ViewTreeObserver.OnGlobalLayoutListener

From interface android.view.LayoutInflater.Factory

From interface android.content.ComponentCallbacks

From interface android.view.SurfaceHolder.Callback

常量(Constants)

META_DATA_FUNC_NAME

Added in API level 9

String META_DATA_FUNC_NAME

可选元，可以在清单此组件，指定的主入口点的名称，在这个天然活性META_DATA_LIB_NAME本地代码。如果未指定，则使用“ANativeActivity_onCreate”。

常量值：“android.app.func_name”

META_DATA_LIB_NAME

Added in API level 9

String META_DATA_LIB_NAME

可选元 - 可以在此组件的清单中，指定要加载的本机共享库的名称。如果未指定，则使用“main”。

常量值：“android.app.lib_name”

Public constructors

NativeActivity

Added in API level 9

NativeActivity ()

公共方法(Public methods)

onConfigurationChanged

Added in API level 9

void onConfigurationChanged (Configuration newConfig)

设备配置在您的活动正在运行时更改时由系统调用。请注意，只有在清单中选择了想要处理configChanges属性的配置时才会调用此选项。如果发生任何未被该属性选择报告的配置更改，则不会报告该系统，系统将停止并重新启动活动（使其通过新配置启动）。

在调用此函数时，您的Resources对象将被更新为返回与新配置相匹配的资源值。

参数(Parameters)
`newConfig`	`Configuration`: The new device configuration.

onGlobalLayout

Added in API level 9

void onGlobalLayout ()

当全局布局状态或视图树中视图的可见性发生更改时调用回调方法

onInputQueueCreated

Added in API level 9

void onInputQueueCreated (InputQueue queue)

当给定的InputQueue现在与进行此调用的线程相关联时调用，因此它可以开始接收来自它的事件。

参数(Parameters)
`queue`	`InputQueue`

onInputQueueDestroyed

Added in API level 9

void onInputQueueDestroyed (InputQueue queue)

当给定的InputQueue不再与该线程关联并因此不调度事件时调用。

参数(Parameters)
`queue`	`InputQueue`

onLowMemory

Added in API level 9

void onLowMemory ()

这在整个系统内存不足时调用，并且主动运行的进程应该修剪内存使用情况。虽然没有定义它的确切位置，但通常会在所有后台进程都被终止时发生。也就是说，在达到托管服务和前台UI的杀死进程之前，我们希望避免杀死。

你应该实现这个方法来释放你可能持有的任何缓存或其他不必要的资源。系统将从此方法返回后为您执行垃圾回收。

最好是，您应该从ComponentCallbacks2实施onTrimMemory(int) ，以基于不同级别的内存需求逐步卸载资源。该API适用于API级别14和更高版本，因此，您应该只使用此onLowMemory()方法作为旧版本的后备方案，可以将其与onTrimMemory(int)的TRIM_MEMORY_COMPLETE级别相同处理。

onWindowFocusChanged

Added in API level 9

void onWindowFocusChanged (boolean hasFocus)

当活动当前Window获得或失去焦点时调用。这是此活动是否对用户可见的最佳指标。默认实现会清除密钥跟踪状态，因此应该始终调用。

请注意，这提供了有关全局焦点状态的信息，该状态与活动生命周期无关地进行管理。因此，虽然重点更改通常与生命周期更改有关（停止的活动通常不会获得窗口焦点），但您不应该依赖这里的回调和其他生命周期方法中的回调之间的任何特定顺序，例如onResume() 。

然而，作为一般规则，恢复的活动将具有窗口焦点...除非它已显示其他对话框或弹出窗口来输入焦点，在这种情况下，当其他窗口具有焦点时，活动本身将不具有焦点。同样，系统可能会显示系统级别的窗口（例如状态栏通知面板或系统警报），该窗口将临时采用窗口输入焦点，而不会暂停前台活动。

参数(Parameters)
`hasFocus`	`boolean`: Whether the window of this activity has focus.

surfaceChanged

Added in API level 9

void surfaceChanged (SurfaceHolder holder, 
                int format, 
                int width, 
                int height)

这是在对表面进行任何结构更改（格式或大小）后立即调用的。此时您应该更新曲面中的图像。此方法总是在surfaceCreated(SurfaceHolder)之后至少调用一次。

参数(Parameters)
`holder`	`SurfaceHolder`: The SurfaceHolder whose surface has changed.
`format`	`int`: The new PixelFormat of the surface.
`width`	`int`: The new width of the surface.
`height`	`int`: The new height of the surface.

surfaceCreated

Added in API level 9

void surfaceCreated (SurfaceHolder holder)

这是在表面首次创建后立即调用的。这个实现应该启动他们想要的任何渲染代码。请注意，只有一个线程可以绘制成Surface ，因此如果您的普通渲染将位于另一个线程中，则不应在此处绘制Surface。

参数(Parameters)
`holder`	`SurfaceHolder`: The SurfaceHolder whose surface is being created.

surfaceDestroyed

Added in API level 9

void surfaceDestroyed (SurfaceHolder holder)

这是在表面被破坏之前立即调用的。从此通话返回后，您不应再尝试访问此表面。如果您有直接访问表面的渲染线程，则必须确保线程在从此函数返回之前不再触摸Surface。

参数(Parameters)
`holder`	`SurfaceHolder`: The SurfaceHolder whose surface is being destroyed.

surfaceRedrawNeeded

Added in API level 9

void surfaceRedrawNeeded (SurfaceHolder holder)

当应用程序需要重新绘制其表面的内容，调整大小或出于某种其他原因时调用。在完成重画之前，如果不从这里返回，则可以确保用户不会看到表面处于不良状态（在以正确方式绘制之前以新尺寸显示）。这通常会在surfaceChanged(SurfaceHolder, int, int, int) 。

参数(Parameters)
`holder`	`SurfaceHolder`: The SurfaceHolder whose surface has changed.

Protected methods

onCreate

Added in API level 9

void onCreate (Bundle savedInstanceState)

当活动开始时调用。这是大多数初始化应该去的地方：调用setContentView(int)来setContentView(int)活动的UI，使用findViewById(int)以编程方式与UI中的小部件进行交互，调用managedQuery(android.net.Uri, String[], String, String[], String)来检索正在显示的数据的光标等。

您可以拨打 finish()从这个函数中，在这种情况下的onDestroy（）将被立即调用没有任何活动的生命周期（其余的 onStart() ， onResume() ， onPause()执行等）。

派生类必须调用超类的这个方法的实现。 如果他们不这样做，就会抛出异常。

参数(Parameters)
`savedInstanceState`	`Bundle`: If the activity is being re-initialized after previously being shut down then this Bundle contains the data it most recently supplied in `onSaveInstanceState(Bundle)`. *Note: Otherwise it is null.*

onDestroy

Added in API level 9

void onDestroy ()

在活动销毁之前执行任何最终清理。这可能是由于活动正在完成（有人称为finish() ，或者系统暂时销毁此活动的实例以节省空间），您可以使用isFinishing()方法区分这两种情况。

注意：不要将此方法称为保存数据的地方！ 例如，如果某个活动正在编辑内容提供者中的数据，则应该在onPause()或onSaveInstanceState(Bundle)提交这些编辑，而不是在这里。 这种方法通常被实现为释放资源，例如与活动相关联的线程，这样一个被销毁的活动就不会离开这些东西，而其他应用程序仍在运行。在某些情况下，系统只会在不调用该方法（或任何其他方法）的情况下终止该活动的托管过程，因此不应该将其用于在过程消失后执行那些旨在保留的事情。

派生类必须调用超类的这个方法的实现。 如果他们不这样做，就会抛出异常。

onPause

Added in API level 9

void onPause ()

作为活动生命周期的一部分，当活动进入后台但尚未（尚未）死亡时调用。对应于onResume() 。

当活动B在活动A前面启动时，此回调将在A上被调用。在A的 onPause()返回之前，B不会被创建，因此请确保在此处不做任何冗长的操作。

此回调主要用于保存活动正在编辑的任何持续状态，向用户呈现“就地编辑”模型，并确保没有足够的资源来启动新活动，而不必先杀死该活动。这也是一个很好的地方，可以停止动画和其他消耗大量CPU的内容，以便尽快切换到下一个活动，或者关闭像摄像机这样的独占访问资源。

在系统需要更多内存的情况下，它可能会终止暂停的进程以回收资源。因此，您应该确保在您从此函数返回时保存所有状态。通常， onSaveInstanceState(Bundle)用于保存活动中的每个实例状态，并且此方法用于存储全局持久数据（位于内容提供者，文件等中）

接到此电话后，您通常会收到以下致电 onStop() （在下一个活动恢复并显示之后），但在某些情况下，将直接回拨至 onResume()而不通过停止状态。

派生类必须调用超类的这个方法的实现。 如果他们不这样做，就会抛出异常。

onResume

Added in API level 9

void onResume ()

后调用onRestoreInstanceState(Bundle) ， onRestart() ，或onPause() ，为您的活动启动与用户交互。这是开始动画，打开专用访问设备（如相机）等的好地方。

请记住，onResume并不是您的活动对用户可见的最佳指标; 系统窗口（如键盘）可能在前面。使用onWindowFocusChanged(boolean)可以确定您的活动对用户是可见的（例如，恢复游戏）。

派生类必须调用超类的这个方法的实现。 如果他们不这样做，就会抛出异常。

onSaveInstanceState

Added in API level 9

void onSaveInstanceState (Bundle outState)

在被杀之前调用以从活动中检索每个实例的状态，以便可以在 onCreate(Bundle)或 onRestoreInstanceState(Bundle)恢复状态（由此方法填充的 Bundle将传递到两者）。

在一个活动可能被杀死之前调用这个方法，以便在将来它有一段时间它可以恢复它的状态。例如，如果活动B在活动A之前启动，并且在某些时刻活动A被杀死以回收资源，则活动A将有机会通过此方法保存其用户界面的当前状态，以便当用户返回时到活动A，可以通过onCreate(Bundle)或onRestoreInstanceState(Bundle)恢复用户界面的状态。

不要将此方法与活动生命周期回调（如onPause() ，后者始终在活动置于后台或销毁途中调用，或在销毁前调用onStop() 。调用onPause()和onStop()时的一个示例，而不是此方法是当用户从活动B返回到活动A时：不需要在B上调用onSaveInstanceState(Bundle) ，因为该特定实例永远不会被恢复，因此系统可以避免调用它。当onPause()而不是onSaveInstanceState(Bundle)时的一个示例是当活动B在活动A前面启动时：如果活动A在A的用户界面的状态期间未在B的生存期中被杀死，则系统可以避免对活动A调用onSaveInstanceState(Bundle)将保持完好。

默认实现通过在具有ID的层次结构中的每个视图上调用onSaveInstanceState()并保存当前焦点视图的ID（所有视图都由缺省实现恢复）来为您处理大部分UI每个实例状态的onRestoreInstanceState(Bundle) ）。如果您重写此方法以保存未被每个视图捕获的附加信息，那么您可能需要调用默认实现，否则应准备好保存每个视图的所有状态。

如果调用，此方法将在onStop()之前onStop() 。无法保证onPause()之前还是之后。

参数(Parameters)
`outState`	`Bundle`: Bundle in which to place your saved state.

onStart

Added in API level 9

void onStart ()

在onCreate(Bundle)之后调用 - 或者在onRestart()之后当活动已停止，但现在再次显示给用户时调用。紧接着是onResume() 。

派生类必须调用超类的这个方法的实现。 如果他们不这样做，就会抛出异常。

onStop

Added in API level 9

void onStop ()

当用户不再可见时调用。接下来，您将收到无论是onRestart() ， onDestroy() ，或没有，这取决于后来的用户活动。

派生类必须调用超类的这个方法的实现。 如果他们不这样做，就会抛出异常。

Interfaces

Classes

Exceptions

Most visited

Recently visited

Results for

NativeActivity

摘要(Summary)

常量(Constants)

Inherited constants

Inherited fields

Public constructors

公共方法(Public methods)

Protected methods

继承方法(Inherited methods)

常量(Constants)

META_DATA_FUNC_NAME

META_DATA_LIB_NAME

Public constructors

NativeActivity

公共方法(Public methods)

onConfigurationChanged

onGlobalLayout

onInputQueueCreated

onInputQueueDestroyed

onLowMemory

onWindowFocusChanged

surfaceChanged

surfaceCreated

surfaceDestroyed

surfaceRedrawNeeded

Protected methods

onCreate

onDestroy

onPause

onResume

onSaveInstanceState

onStart

onStop