MockContext

MockContext

MockContext ()

bindService

boolean bindService (Intent service, 
                ServiceConnection conn, 
                int flags)

连接到应用程序服务，根据需要创建它。 这定义了应用程序和服务之间的依赖关系。 给定的conn在创建时会收到服务对象，并被告知它是否会死亡并重新启动。 只要存在调用上下文，该服务就会被系统认为是必需的。 例如，如果此Context是一个已停止的Activity，则该服务将不需要继续运行，直到活动恢复。

如果您没有绑定到给定服务的权限，则此函数将抛出 SecurityException 。

注意：此方法不能从BroadcastReceiver组件调用 。 您可以用来从BroadcastReceiver通信到某个服务的模式是使用包含要发送命令的参数调用startService(Intent) ，该服务在完成该命令时调用其stopSelf(int)方法。 请参阅API演示应用程序/服务/服务启动参数控制器以获取此示例。 但是，从已经注册到registerReceiver(BroadcastReceiver, IntentFilter)的BroadcastReceiver使用此方法是可以的，因为此BroadcastReceiver的生命周期与另一个对象（注册它的对象）相关联。

checkCallingOrSelfPermission

int checkCallingOrSelfPermission (String permission)

确定IPC的调用过程还是您已被授予特定权限。 这与checkCallingPermission(String)相同，只是如果您当前checkCallingPermission(String) ，则会授予您自己的权限。 小心使用！

checkCallingOrSelfUriPermission

int checkCallingOrSelfUriPermission (Uri uri, 
                int modeFlags)

确定IPC的调用进程或您是否被授予访问特定URI的权限。 这与checkCallingUriPermission(Uri, int)相同，只是如果您当前checkCallingUriPermission(Uri, int) ，则会授予您自己的权限。 小心使用！

checkCallingPermission

int checkCallingPermission (String permission)

确定您正在处理的IPC的调用进程是否已被授予特定权限。 这与使用由getCallingPid()和getCallingUid()返回的pid和uid调用checkPermission(String, int, int)基本相同。 一个重要的区别是，如果您目前没有处理IPC，该功能将始终失败。 这样做是为了防止意外泄漏的权限; 你可以使用checkCallingOrSelfPermission(String)来避免这种保护。

checkCallingUriPermission

int checkCallingUriPermission (Uri uri, 
                int modeFlags)

确定调用进程和用户标识是否已被授予访问特定URI的权限。 这与使用getCallingPid()和getCallingUid()返回的pid和uid调用checkUriPermission(Uri, int, int, int)基本相同。 一个重要的区别是，如果您目前没有处理IPC，该功能将始终失败。

checkPermission

int checkPermission (String permission, 
                int pid, 
                int uid)

确定是否允许给定的权限用于系统中运行的特定进程和用户标识。

checkSelfPermission

int checkSelfPermission (String permission)

确定 您是否已获得特定权限。

checkUriPermission

int checkUriPermission (Uri uri, 
                String readPermission, 
                String writePermission, 
                int pid, 
                int uid, 
                int modeFlags)

检查Uri和普通权限。 这允许您在一个呼叫中执行checkPermission(String, int, int)和checkUriPermission(Uri, int, int, int) 。

checkUriPermission

int checkUriPermission (Uri uri, 
                int pid, 
                int uid, 
                int modeFlags)

确定是否已授予特定进程和用户标识访问特定URI的权限。 这只会检查已被显式授予的权限 - 如果给定的进程/ uid对URI的内容提供者具有更多的一般访问权限，则此检查将始终失败。

clearWallpaper

void clearWallpaper ()

此方法已弃用。
改为使用WallpaperManager.clear() 。

此方法要求调用方拥有权限 SET_WALLPAPER 。

createConfigurationContext

Context createConfigurationContext (Configuration overrideConfiguration)

为当前上下文返回一个新的Context对象，但其资源被调整以匹配给定的配置。 每次调用此方法都会返回一个Context对象的新实例; 上下文对象不共享，但是常见的状态（ClassLoader，用于相同配置的其他资源）可能是这样的，上下文本身可以是相当轻量级的。

createDeviceProtectedStorageContext

Context createDeviceProtectedStorageContext ()

为当前上下文返回一个新的Context对象，但其存储API由受设备保护的存储支持。

在直接引导的设备上，存储在此位置的数据使用绑定到物理设备的密钥进行加密，并且可以在设备成功引导后立即访问，无论是 在用户使用凭据进行身份验证 之前还是之后 （例如锁定模式或PIN）。

由于受到设备保护的数据在没有用户身份验证的情况下可用，因此应谨慎限制使用此上下文存储的数据。 例如，强烈建议不要在设备保护区域中存储敏感身份验证令牌或密码。

如果底层设备无法使用不同的密钥存储受设备保护和凭据保护的数据，则两个存储区域将同时可用。 它们仍然是磁盘上两个不同的存储位置，只有可用性窗口发生变化。

每次调用此方法都会返回一个Context对象的新实例; 上下文对象不共享，但是常见的状态（ClassLoader，用于相同配置的其他资源）可能是这样的，上下文本身可以是相当轻量级的。

createDisplayContext

Context createDisplayContext (Display display)

为当前上下文返回一个新的Context对象，但其资源被调整为匹配给定Display的指标。 每次调用此方法都会返回一个Context对象的新实例; 上下文对象不共享，但是常见的状态（ClassLoader，用于相同配置的其他资源）可能是这样的，上下文本身可以是相当轻量级的。 返回的显示上下文提供了一个WindowManager （请参阅getSystemService(String) ），它被配置为在给定的显示器上显示窗口。 WindowManager的getDefaultDisplay()方法可用于从返回的上下文中检索显示。

createPackageContext

Context createPackageContext (String packageName, 
                int flags)

为给定的应用程序名称返回一个新的Context对象。 此上下文与启动时的命名应用程序相同，其中包含相同的资源和类加载器。 每次调用此方法都会返回一个Context对象的新实例; 上下文对象不共享，但它们共享公共状态（Resources，ClassLoader等），因此Context实例本身相当轻量级。

如果没有给定包名称的应用程序，则引发 PackageManager.NameNotFoundException 。

抛出 SecurityException如果请求上下文不能加载到呼叫者的出于安全原因（见过程 CONTEXT_INCLUDE_CODE更多信息}。

databaseList

String[] databaseList ()

返回一个字符串数组，命名与此Context的应用程序包关联的专用数据库。

deleteDatabase

boolean deleteDatabase (String name)

删除与此Context的应用程序包关联的现有私有SQLiteDatabase。

deleteFile

boolean deleteFile (String name)

删除与此Context的应用程序包关联的给定私人文件。

deleteSharedPreferences

boolean deleteSharedPreferences (String name)

删除现有的共享首选项文件。

enforceCallingOrSelfPermission

void enforceCallingOrSelfPermission (String permission, 
                String message)

如果您和您正在处理的IPC的调用过程都未获得特定许可，请扔出SecurityException 。 这与enforceCallingPermission(String, String)相同，只是它授予您自己的权限（如果您当前enforceCallingPermission(String, String) IPC）。 小心使用！

enforceCallingOrSelfUriPermission

void enforceCallingOrSelfUriPermission (Uri uri, 
                int modeFlags, 
                String message)

如果IPC的调用进程或您未被授予访问特定URI的权限，则抛出SecurityException 。 这与enforceCallingUriPermission(Uri, int, String)相同，只是如果您当前enforceCallingUriPermission(Uri, int, String) ，则会授予您自己的权限。 小心使用！

enforceCallingPermission

void enforceCallingPermission (String permission, 
                String message)

如果您正在处理的IPC的调用过程尚未获得特定许可，请扔出SecurityException 。 这与使用getCallingPid()和getCallingUid()返回的pid和uid调用enforcePermission(String, int, int, String)基本相同。 一个重要的区别是，如果您当前没有处理IPC，则此函数将始终引发SecurityException。 这样做是为了防止意外泄漏的权限; 你可以使用enforceCallingOrSelfPermission(String, String)来避免这种保护。

enforceCallingUriPermission

void enforceCallingUriPermission (Uri uri, 
                int modeFlags, 
                String message)

如果调用进程和用户标识没有被授予访问特定URI的权限，则抛出SecurityException 。 这与使用由getCallingPid()和getCallingUid()返回的pid和uid调用enforceUriPermission(Uri, int, int, int, String)基本相同。 一个重要的区别是，如果您当前没有处理IPC，则此函数将始终引发SecurityException。

enforcePermission

void enforcePermission (String permission, 
                int pid, 
                int uid, 
                String message)

如果给定权限不允许用于系统中运行的特定进程和用户标识，请输入 SecurityException 。

enforceUriPermission

void enforceUriPermission (Uri uri, 
                String readPermission, 
                String writePermission, 
                int pid, 
                int uid, 
                int modeFlags, 
                String message)

强制执行Uri和普通权限。 这允许您在一个呼叫中执行enforcePermission(String, int, int, String)和enforceUriPermission(Uri, int, int, int, String) 。

enforceUriPermission

void enforceUriPermission (Uri uri, 
                int pid, 
                int uid, 
                int modeFlags, 
                String message)

如果某个特定的进程和用户标识没有被授予访问特定URI的权限，则抛出SecurityException 。 这只会检查已被显式授予的权限 - 如果给定的进程/ uid对URI的内容提供者具有更多的一般访问权限，则此检查将始终失败。

fileList

String[] fileList ()

返回一个字符串数组，命名与此Context的应用程序包关联的私有文件。

getApplicationContext

Context getApplicationContext ()

返回当前进程的单个全局应用程序对象的上下文。 这通常只应用于需要生命周期与当前上下文分离的Context，该生命周期与进程的生命周期相关，而不是当前组件。

考虑一下如何与 registerReceiver(BroadcastReceiver, IntentFilter)交互：

• 如果从Activity上下文中使用，接收者正在该活动中注册。 这意味着您需要在活动完成之前取消注册; 事实上，如果你不这样做，框架会清除你的泄漏注册，因为它会删除活动并记录错误。 因此，如果使用Activity上下文来注册一个静态的接收者（对进程是全局的，而不是与一个Activity实例关联的），那么在你使用的活动被销毁的任何点上，你的注册将被删除。

• 如果从此处返回的Context使用，则接收者正在注册与您的应用程序关联的全局状态。 因此它永远不会被注销。 如果接收器与静态数据相关联，而不是特定组件，则这是必要的。 但是，如果您忘记取消注册，取消绑定等操作，则在别处使用ApplicationContext可能会导致严重泄漏。

getApplicationInfo

ApplicationInfo getApplicationInfo ()

返回此上下文包的完整应用程序信息。

getAssets

AssetManager getAssets ()

返回应用程序包的AssetManager实例。

注意：此方法的实现应该返回一个AssetManager实例，该实例与getResources()返回的Resources实例一致。 例如，他们应该共享相同的Configuration对象。

getCacheDir

File getCacheDir ()

返回文件系统上特定于应用程序的缓存目录的绝对路径。 这些文件将在设备存储空间不足时被首先删除。 这些文件将被删除时无法保证。

注意：您不应该依赖系统为您删除这些文件; 对于缓存文件占用的空间量，您应始终拥有合理的最大值（例如1 MB），并在超过该空间时修剪这些文件。

如果调用应用程序移动到采用的存储设备，则返回的路径可能会随时间而改变，因此只应保留相对路径。

应用程序不需要额外的权限来读取或写入返回的路径，因为此路径位于其私有存储中。

getClassLoader

ClassLoader getClassLoader ()

返回一个你可以用来检索这个包中的类的类加载器。

getCodeCacheDir

File getCodeCacheDir ()

返回专用于存储缓存代码的文件系统上特定于应用程序的缓存目录的绝对路径。 无论何时升级您的特定应用程序以及升级整个平台时，系统都会删除存储在此位置的所有文件。

此位置适用于存储由应用程序在运行时生成的编译或优化的代码。

如果调用应用程序移动到采用的存储设备，则返回的路径可能会随时间而改变，因此只应保留相对路径。

应用程序不需要额外的权限来读取或写入返回的路径，因为此路径位于其私有存储中。

getContentResolver

ContentResolver getContentResolver ()

为你的应用程序包返回一个ContentResolver实例。

getDataDir

File getDataDir ()

返回存储属于此应用程序的所有私人文件的文件系统上目录的绝对路径。 应用程序不应该直接使用此路径; 他们应该使用getFilesDir() ， getCacheDir() ， getDir(String, int)这个类，或者其他存储API。

如果调用应用程序移动到采用的存储设备，则返回的路径可能会随时间而改变，因此只应保留相对路径。

调用应用程序无需额外的权限即可读取或写入返回路径下的文件。

getDatabasePath

File getDatabasePath (String name)

返回存储使用 openOrCreateDatabase(String, int, SQLiteDatabase.CursorFactory)创建的数据库的文件系统上的绝对路径。

如果调用应用程序移动到采用的存储设备，则返回的路径可能会随时间而改变，因此只应保留相对路径。

getDir

File getDir (String name, 
                int mode)

根据需要检索，创建应用程序可以放置自己的自定义数据文件的新目录。 您可以使用返回的File对象来创建和访问此目录中的文件。 请注意，通过File对象创建的文件只能由您自己的应用程序访问; 您只能设置整个目录的模式，而不是单个文件。

如果调用应用程序移动到采用的存储设备，则返回的路径可能会随时间而改变，因此只应保留相对路径。

应用程序不需要额外的权限来读取或写入返回的路径，因为此路径位于其私有存储中。

getExternalCacheDir

File getExternalCacheDir ()

返回应用程序可以放置其拥有的缓存文件的主共享/外部存储设备上特定于应用程序的目录的绝对路径。 这些文件是应用程序的内部文件，并且通常不会作为媒体显示给用户。

这就像 getCacheDir()一样，这些文件在卸载应用程序时会被删除，但是有一些重要的区别：

• The platform does not always monitor the space available in shared storage, and thus may not automatically delete these files. Apps should always manage the maximum space used in this location. Currently the only time files here will be deleted by the platform is when running on JELLY_BEAN_MR1 or later and isExternalStorageEmulated(File) returns true.
• Shared storage may not always be available, since removable media can be ejected by the user. Media state can be checked using getExternalStorageState(File).
• There is no security enforced with these files. For example, any application holding WRITE_EXTERNAL_STORAGE can write to these files.

如果模拟共享存储设备（由 isExternalStorageEmulated(File)确定），则其内容由专用用户数据分区支持，这意味着在此处存储数据没有多大好处，而不是由 getCacheDir()返回的专用目录。

从KITKAT开始，不需要读取或写入返回路径的权限; 它始终可供调用应用程序访问。 这仅适用于为调用应用程序的包名称生成的路径。 要访问属于其他包的路径，需要WRITE_EXTERNAL_STORAGE和/或READ_EXTERNAL_STORAGE 。

在具有多个用户的设备上（如UserManager ），每个用户都有自己独立的共享存储。 应用程序只能访问正在运行的用户的共享存储。

如果插入不同的共享存储介质，返回的路径可能随时间而改变，因此只应保留相对路径。

getExternalCacheDirs

File[] getExternalCacheDirs ()

返回应用程序可以放置它拥有的缓存文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。 这些文件是应用程序的内部文件，并且通常不会作为媒体显示给用户。

这就像 getCacheDir()一样，这些文件在卸载应用程序时会被删除，但是还是有一些重要的区别：

• The platform does not always monitor the space available in shared storage, and thus may not automatically delete these files. Apps should always manage the maximum space used in this location. Currently the only time files here will be deleted by the platform is when running on JELLY_BEAN_MR1 or later and isExternalStorageEmulated(File) returns true.
• Shared storage may not always be available, since removable media can be ejected by the user. Media state can be checked using getExternalStorageState(File).
• There is no security enforced with these files. For example, any application holding WRITE_EXTERNAL_STORAGE can write to these files.

如果模拟共享存储设备（由 isExternalStorageEmulated(File)确定），则其内容由专用用户数据分区支持，这意味着在此处存储数据没有多大好处，而不是由 getCacheDir()返回的专用目录。

这里返回的共享存储设备被认为是设备的稳定部分，包括保护盖下的物理介质插槽。 返回的路径不包括瞬时设备，例如连接到手持设备的USB闪存驱动器。

应用程序可以将数据存储在任何或所有返回的设备上。 例如，应用程序可能会选择将大文件存储在具有最大可用空间的设备上，如StatFs 。

调用应用程序无需额外的权限即可读取或写入返回路径下的文件。 在辅助外部存储设备上写入这些路径之外的访问权限不可用。

如果插入不同的共享存储介质，返回的路径可能随时间而改变，因此只应保持相对路径。

getExternalFilesDir

File getExternalFilesDir (String type)

返回应用程序可以放置其拥有的持久性文件的主共享/外部存储设备上目录的绝对路径。 这些文件是应用程序的内部文件，对于用户而言通常不可见为媒体。

这类似于 getFilesDir() ，因为这些文件在卸载应用程序时将被删除，但是存在一些重要区别：

• Shared storage may not always be available, since removable media can be ejected by the user. Media state can be checked using getExternalStorageState(File).
• There is no security enforced with these files. For example, any application holding WRITE_EXTERNAL_STORAGE can write to these files.

如果模拟共享存储设备（由 isExternalStorageEmulated(File)确定），则其内容由专用用户数据分区支持，这意味着在这里存储数据没有多大好处，而不是 getFilesDir()返回的专用目录等。

从KITKAT开始，不需要读取或写入返回路径的权限; 它始终可供调用应用程序访问。 这仅适用于为调用应用程序的包名称生成的路径。 要访问属于其他包的路径，需要WRITE_EXTERNAL_STORAGE和/或READ_EXTERNAL_STORAGE 。

在具有多个用户的设备上（如UserManager ），每个用户都有自己独立的共享存储。 应用程序只能访问正在运行的用户的共享存储。

如果插入不同的共享存储介质，返回的路径可能随时间而改变，因此只应保留相对路径。

以下是操作应用程序共享存储中的文件的典型代码示例：

void createExternalStoragePrivateFile() {
    // Create a path where we will place our private file on external
    // storage.
    File file = new File(getExternalFilesDir(null), "DemoFile.jpg");

    try {
        // Very simple code to copy a picture from the application's
        // resource into the external file.  Note that this code does
        // no error checking, and assumes the picture is small (does not
        // try to copy it in chunks).  Note that if external storage is
        // not currently mounted this will silently fail.
        InputStream is = getResources().openRawResource(R.drawable.balloons);
        OutputStream os = new FileOutputStream(file);
        byte[] data = new byte[is.available()];
        is.read(data);
        os.write(data);
        is.close();
        os.close();
    } catch (IOException e) {
        // Unable to create file, likely because external storage is
        // not currently mounted.
        Log.w("ExternalStorage", "Error writing " + file, e);
    }
}

void deleteExternalStoragePrivateFile() {
    // Get path for the file on external storage.  If external
    // storage is not currently mounted this will fail.
    File file = new File(getExternalFilesDir(null), "DemoFile.jpg");
    if (file != null) {
        file.delete();
    }
}

boolean hasExternalStoragePrivateFile() {
    // Get path for the file on external storage.  If external
    // storage is not currently mounted this will fail.
    File file = new File(getExternalFilesDir(null), "DemoFile.jpg");
    if (file != null) {
        return file.exists();
    }
    return false;
}

如果您为此函数提供非null 类型 ，则返回的文件将成为给定类型的子目录的路径。 尽管媒体扫描程序不会自动扫描这些文件，但您可以使用MediaScannerConnection.scanFile将它们明确添加到媒体数据库中。 请注意，这与Environment.getExternalStoragePublicDirectory() ，后者提供所有应用程序共享的媒体目录。 这里返回的目录由应用程序拥有，当应用程序被卸载时，它们的内容将被删除。 与Environment.getExternalStoragePublicDirectory()不同，此处返回的目录将自动为您创建。

以下是处理应用程序共享存储中的图片并将其添加到媒体数据库的典型代码示例：

void createExternalStoragePrivatePicture() {
    // Create a path where we will place our picture in our own private
    // pictures directory.  Note that we don't really need to place a
    // picture in DIRECTORY_PICTURES, since the media scanner will see
    // all media in these directories; this may be useful with other
    // media types such as DIRECTORY_MUSIC however to help it classify
    // your media for display to the user.
    File path = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    File file = new File(path, "DemoPicture.jpg");

    try {
        // Very simple code to copy a picture from the application's
        // resource into the external file.  Note that this code does
        // no error checking, and assumes the picture is small (does not
        // try to copy it in chunks).  Note that if external storage is
        // not currently mounted this will silently fail.
        InputStream is = getResources().openRawResource(R.drawable.balloons);
        OutputStream os = new FileOutputStream(file);
        byte[] data = new byte[is.available()];
        is.read(data);
        os.write(data);
        is.close();
        os.close();

        // Tell the media scanner about the new file so that it is
        // immediately available to the user.
        MediaScannerConnection.scanFile(this,
                new String[] { file.toString() }, null,
                new MediaScannerConnection.OnScanCompletedListener() {
            public void onScanCompleted(String path, Uri uri) {
                Log.i("ExternalStorage", "Scanned " + path + ":");
                Log.i("ExternalStorage", "-> uri=" + uri);
            }
        });
    } catch (IOException e) {
        // Unable to create file, likely because external storage is
        // not currently mounted.
        Log.w("ExternalStorage", "Error writing " + file, e);
    }
}

void deleteExternalStoragePrivatePicture() {
    // Create a path where we will place our picture in the user's
    // public pictures directory and delete the file.  If external
    // storage is not currently mounted this will fail.
    File path = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    if (path != null) {
        File file = new File(path, "DemoPicture.jpg");
        file.delete();
    }
}

boolean hasExternalStoragePrivatePicture() {
    // Create a path where we will place our picture in the user's
    // public pictures directory and check if the file exists.  If
    // external storage is not currently mounted this will think the
    // picture doesn't exist.
    File path = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    if (path != null) {
        File file = new File(path, "DemoPicture.jpg");
        return file.exists();
    }
    return false;
}

getExternalFilesDirs

File[] getExternalFilesDirs (String type)

返回应用程序可以放置其拥有的持久性文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。 这些文件是应用程序的内部文件，并且通常不会作为媒体显示给用户。

这就像 getFilesDir() ，因为卸载应用程序时这些文件将被删除，但是有一些重要的区别：

• Shared storage may not always be available, since removable media can be ejected by the user. Media state can be checked using getExternalStorageState(File).
• There is no security enforced with these files. For example, any application holding WRITE_EXTERNAL_STORAGE can write to these files.

如果模拟共享存储设备（由 isExternalStorageEmulated(File)确定），则其内容由专用用户数据分区支持，这意味着在此处存储数据没有多大好处，而不是由 getFilesDir()等返回的专用目录等。

这里返回的共享存储设备被认为是设备的稳定部分，包括保护盖下的物理介质插槽。 返回的路径不包括瞬时设备，例如连接到手持设备的USB闪存驱动器。

应用程序可以将数据存储在任何或所有返回的设备上。 例如，应用程序可能会选择将大文件存储在具有最大可用空间的设备上，如StatFs所测量的StatFs 。

调用应用程序无需额外的权限即可读取或写入返回路径下的文件。 在辅助外部存储设备上写入这些路径之外的访问权限不可用。

如果插入不同的共享存储介质，返回的路径可能随时间而改变，因此只应保留相对路径。

getExternalMediaDirs

File[] getExternalMediaDirs ()

返回应用程序可放置媒体文件的所有共享/外部存储设备上特定于应用程序的目录的绝对路径。 扫描这些文件并通过MediaStore将其提供给其他应用程序。

这就像 getExternalFilesDirs(String) ，因为这些文件在卸载应用程序时会被删除，但是还是有一些重要的区别：

• Shared storage may not always be available, since removable media can be ejected by the user. Media state can be checked using getExternalStorageState(File).
• There is no security enforced with these files. For example, any application holding WRITE_EXTERNAL_STORAGE can write to these files.

这里返回的共享存储设备被认为是设备的稳定部分，包括保护盖下的物理介质插槽。 返回的路径不包括瞬时设备，例如连接到手持设备的USB闪存驱动器。

应用程序可以将数据存储在任何或所有返回的设备上。 例如，应用程序可能会选择将大文件存储在具有最多可用空间的设备上，如StatFs 。

调用应用程序无需额外的权限即可读取或写入返回路径下的文件。 在辅助外部存储设备上写入这些路径之外的访问权限不可用。

如果插入不同的共享存储介质，返回的路径可能随时间而改变，因此只应保持相对路径。

getFileStreamPath

File getFileStreamPath (String name)

返回存储使用 openFileOutput(String, int)创建的文件的文件系统上的绝对路径。

如果调用应用程序移动到采用的存储设备，则返回的路径可能会随时间而改变，因此只应保留相对路径。

getFilesDir

File getFilesDir ()

返回存储使用 openFileOutput(String, int)创建的文件的文件系统上目录的绝对路径。

如果调用应用程序移动到采用的存储设备，则返回的路径可能会随时间而改变，因此只应保留相对路径。

调用应用程序无需额外的权限即可读取或写入返回路径下的文件。

getMainLooper

Looper getMainLooper ()

返回当前进程主线程的Looper。 这是用于调用应用程序组件（活动，服务等）的线程。

根据定义，此方法返回与调用 Looper.getMainLooper()所获得的结果相同的结果。

getNoBackupFilesDir

File getNoBackupFilesDir ()

返回类似于getFilesDir()的文件系统上目录的绝对路径。 不同之处在于放置在该目录下的文件将被排除在远程存储的自动备份之外。 有关Android中的自动备份机制的完整讨论，请参阅BackupAgent 。

如果调用应用程序移动到采用的存储设备，则返回的路径可能会随时间而改变，因此只应保留相对路径。

调用应用程序无需额外的权限即可读取或写入返回路径下的文件。

getObbDir

File getObbDir ()

返回此应用程序的OBB文件（如果有）的主要共享/外部存储目录。 请注意，如果应用程序没有任何OBB文件，则该目录可能不存在。

这就像 getFilesDir() ，这些文件在卸载应用程序时将被删除，但是有一些重要的区别：

• Shared storage may not always be available, since removable media can be ejected by the user. Media state can be checked using getExternalStorageState(File).
• There is no security enforced with these files. For example, any application holding WRITE_EXTERNAL_STORAGE can write to these files.

从KITKAT开始，不需要读取或写入返回路径的权限; 它始终可供调用应用程序访问。 这仅适用于为调用应用程序的包名称生成的路径。 要访问属于其他包的路径，需要WRITE_EXTERNAL_STORAGE和/或READ_EXTERNAL_STORAGE 。

在具有多个用户的设备上（如UserManager ），多个用户可能共享相同的OBB存储位置。 应用程序应确保在不同用户下运行的多个实例不会相互干扰。

getObbDirs

File[] getObbDirs ()

返回应用程序的OBB文件（如果有）的所有共享/外部存储设备上的应用程序特定目录的绝对路径。 请注意，如果应用程序没有任何OBB文件，这些目录可能不存在。

这类似于 getFilesDir() ，因为这些文件在卸载应用程序时将被删除，但有一些重要的区别：

• Shared storage may not always be available, since removable media can be ejected by the user. Media state can be checked using getExternalStorageState(File).
• There is no security enforced with these files. For example, any application holding WRITE_EXTERNAL_STORAGE can write to these files.

这里返回的共享存储设备被认为是设备的稳定部分，包括保护盖下的物理介质插槽。 返回的路径不包括瞬时设备，例如连接到手持设备的USB闪存驱动器。

应用程序可以将数据存储在任何或所有返回的设备上。 例如，应用程序可以选择将大文件存储在具有最多可用空间的设备上，如StatFs所测量的StatFs 。

调用应用程序无需额外的权限即可读取或写入返回路径下的文件。 在辅助外部存储设备上写入这些路径之外的访问权限不可用。

getPackageCodePath

String getPackageCodePath ()

返回此上下文的主要Android包的完整路径。 Android包是一个ZIP文件，其中包含应用程序的主要代码和资产。

注意：这对于应用程序通常不是很有用，因为它们不应该直接访问文件系统。

getPackageManager

PackageManager getPackageManager ()

返回PackageManager实例以查找全局包信息。

getPackageName

String getPackageName ()

返回此应用程序包的名称。

getPackageResourcePath

String getPackageResourcePath ()

返回此上下文的主要Android包的完整路径。 Android包是一个包含应用程序主要资源的ZIP文件。

注意：这对于应用程序通常不是很有用，因为它们不应该直接访问文件系统。

getResources

Resources getResources ()

返回应用程序包的资源实例。

注意：此方法的实现应返回一个与getAssets()返回的AssetManager实例一致的资源实例。 例如，他们应该共享相同的Configuration对象。

getSharedPreferences

SharedPreferences getSharedPreferences (String name, 
                int mode)

检索并保存首选项文件'name'的内容，返回一个SharedPreferences，通过它可以检索和修改其值。 只有一个SharedPreferences对象的实例返回给同一名称的任何调用者，这意味着他们一旦创建就会看到对方的编辑。

getSystemService

Object getSystemService (String name)

按名称将句柄返回到系统级服务。 返回的对象的类因所请求的名称而异。 目前可用的名称是：

WINDOW_SERVICE ("window")

The top-level window manager in which you can place custom windows. The returned object is a WindowManager.

LAYOUT_INFLATER_SERVICE ("layout_inflater")

A LayoutInflater for inflating layout resources in this context.

ACTIVITY_SERVICE ("activity")

A ActivityManager for interacting with the global activity state of the system.

POWER_SERVICE ("power")

A PowerManager for controlling power management.

ALARM_SERVICE ("alarm")

A AlarmManager for receiving intents at the time of your choosing.

NOTIFICATION_SERVICE ("notification")

A NotificationManager for informing the user of background events.

KEYGUARD_SERVICE ("keyguard")

A KeyguardManager for controlling keyguard.

LOCATION_SERVICE ("location")

A LocationManager for controlling location (e.g., GPS) updates.

SEARCH_SERVICE ("search")

A SearchManager for handling search.

VIBRATOR_SERVICE ("vibrator")

A Vibrator for interacting with the vibrator hardware.

CONNECTIVITY_SERVICE ("connection")

A ConnectivityManager for handling management of network connections.

WIFI_SERVICE ("wifi")

A WifiManager for management of Wi-Fi connectivity.

WIFI_P2P_SERVICE ("wifip2p")

A WifiP2pManager for management of Wi-Fi Direct connectivity.

INPUT_METHOD_SERVICE ("input_method")

An InputMethodManager for management of input methods.

UI_MODE_SERVICE ("uimode")

An UiModeManager for controlling UI modes.

DOWNLOAD_SERVICE ("download")

A DownloadManager for requesting HTTP downloads

BATTERY_SERVICE ("batterymanager")

A BatteryManager for managing battery state

JOB_SCHEDULER_SERVICE ("taskmanager")

A JobScheduler for managing scheduled tasks

NETWORK_STATS_SERVICE ("netstats")

A NetworkStatsManager for querying network usage statistics.

HARDWARE_PROPERTIES_SERVICE ("hardware_properties")

A HardwarePropertiesManager for accessing hardware properties.

注意：通过此API获取的系统服务可能与它们从中获取的上下文紧密相关。 一般来说，不要在各种不同的上下文（活动，应用程序，服务，提供者等）之间共享服务对象，

getSystemServiceName

String getSystemServiceName (Class<?> serviceClass)

获取由指定的类表示的系统级服务的名称。

getTheme

Resources.Theme getTheme ()

返回与此上下文关联的主题对象。

getWallpaper

Drawable getWallpaper ()

此方法已弃用。
改为使用WallpaperManager.get() 。

getWallpaperDesiredMinimumHeight

int getWallpaperDesiredMinimumHeight ()

This method is deprecated.
Use WallpaperManager.getDesiredMinimumHeight() instead.

getWallpaperDesiredMinimumWidth

int getWallpaperDesiredMinimumWidth ()

此方法已弃用。
改为使用WallpaperManager.getDesiredMinimumWidth() 。

grantUriPermission

void grantUriPermission (String toPackage, 
                Uri uri, 
                int modeFlags)

无论该软件包是否具有访问Uri内容提供者的一般权限，都可以授予访问另一个软件包的特定Uri的权限。 这可用于授予特定的临时权限，通常用于响应用户交互（例如用户打开您希望其他人显示的附件）。

通常情况下，您应该使用Intent.FLAG_GRANT_READ_URI_PERMISSION或Intent.FLAG_GRANT_WRITE_URI_PERMISSION ，Intent用于直接启动活动而不是此功能。 如果您直接使用此功能，则应该确保在不再允许目标访问目标时调用revokeUriPermission(Uri, int) 。

要成功，拥有Uri的内容提供商必须在其清单中设置 grantUriPermissions属性或包含 <grant-uri-permissions>标签。

isDeviceProtectedStorage

boolean isDeviceProtectedStorage ()

指示此Context的存储API是否受设备保护存储支持。

isRestricted

boolean isRestricted ()

指示此上下文是否受限制。

moveDatabaseFrom

boolean moveDatabaseFrom (Context sourceContext, 
                String name)

将现有数据库文件从给定的源存储上下文移动到此上下文。 这通常用于在升级后在存储位置之间迁移数据，例如迁移到设备保护存储。

数据库在移动之前必须关闭。

moveSharedPreferencesFrom

boolean moveSharedPreferencesFrom (Context sourceContext, 
                String name)

将现有的共享首选项文件从给定的源存储上下文移至此上下文。 这通常用于升级后在存储位置之间迁移数据，例如迁移到设备保护存储。

openFileInput

FileInputStream openFileInput (String name)

打开与此Context的应用程序包关联的私人文件以供阅读。

openFileOutput

FileOutputStream openFileOutput (String name, 
                int mode)

打开与此Context的应用程序包关联的私有文件以进行写入。 如果该文件不存在，则创建该文件。

调用应用程序无需额外的权限来读取或写入返回的文件。

openOrCreateDatabase

SQLiteDatabase openOrCreateDatabase (String file, 
                int mode, 
                SQLiteDatabase.CursorFactory factory, 
                DatabaseErrorHandler errorHandler)

打开与此Context的应用程序包关联的新私有SQLiteDatabase。 如果数据库文件不存在，则创建该文件。

接受输入参数：当sqlite报告数据库损坏时，用于处理腐败的具体实例 DatabaseErrorHandler 。

openOrCreateDatabase

SQLiteDatabase openOrCreateDatabase (String file, 
                int mode, 
                SQLiteDatabase.CursorFactory factory)

打开与此Context的应用程序包关联的新私有SQLiteDatabase。 如果数据库文件不存在，请创建它。

peekWallpaper

Drawable peekWallpaper ()

此方法已弃用。
改为使用WallpaperManager.peek() 。

registerReceiver

Intent registerReceiver (BroadcastReceiver receiver, 
                IntentFilter filter)

注册BroadcastReceiver以在主要活动线程中运行。 接收器将在主应用程序线程中与任何匹配过滤器的广播Intent一起调用。

系统可能会广播“粘性”的内容 - 在广播结束后，这些内容将保留下来，以便发送给任何以后的注册。 如果您的IntentFilter匹配这些粘意图之一，这一意图将这个函数返回时就好像刚刚被广播发送到您的接收器 。

可能有多个匹配过滤器的粘性内容，在这种情况下，每个内容都将被发送到接收方 。 在这种情况下，函数只能直接返回其中的一个; 哪些返回是由系统任意决定的。

如果您知道您注册的意图是粘性的，您可以为您的接收器提供空值。 在这种情况下，没有接收者注册 - 该函数只是返回匹配过滤器的粘性Intent。 在多个匹配的情况下，应用与上述相同的规则。

有关意向广播的更多信息，请参阅 BroadcastReceiver 。

从ICE_CREAM_SANDWICH ，使用此方法注册的接收方将正确地遵守为正在广播的Intent指定的setPackage(String) 。 在此之前，它将被忽略并交付给所有匹配的注册接收者。 如果使用它来保证安全，请小心。

注意：该方法不能从BroadcastReceiver组件调用; 也就是从应用程序清单中声明的BroadcastReceiver。 但是，从另一个BroadcastReceiver调用此方法是可以的，因为这种已注册的BroadcastReceiver的生命周期与注册该对象的对象绑定在一起，该方法本身已在运行时注册为registerReceiver(BroadcastReceiver, IntentFilter) 。

registerReceiver

Intent registerReceiver (BroadcastReceiver receiver, 
                IntentFilter filter, 
                String broadcastPermission, 
                Handler scheduler)

注册以接收意图广播，以在调度程序的上下文中运行。 有关更多信息，请参阅registerReceiver(BroadcastReceiver, IntentFilter) 。 这使您可以强制谁可以向接收者广播意图，或使接收者在与主应用程序线程不同的线程中运行。

有关意向广播的更多信息，请参阅 BroadcastReceiver 。

从ICE_CREAM_SANDWICH ，使用此方法注册的接收方将正确地遵守为广播的Intent指定的setPackage(String) 。 在此之前，它将被忽略并交付给所有匹配的注册接收者。 如果使用它来保证安全，请小心。

removeStickyBroadcast

void removeStickyBroadcast (Intent intent)

此方法已弃用。
不应使用粘滞广播。 它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。 推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。

删除之前与 sendStickyBroadcast(Intent)发送的数据，这样就好像粘性广播从未发生过一样。

您必须持有BROADCAST_STICKY权限才能使用此API。 如果您未获得该权限，则会抛出SecurityException 。

removeStickyBroadcastAsUser

void removeStickyBroadcastAsUser (Intent intent, 
                UserHandle user)

此方法已弃用。
不应使用粘滞广播。 它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。 推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。

版本removeStickyBroadcast(Intent) ，允许您指定广播将被发送到的用户。 这不适用于系统映像上未预安装的应用程序。 使用它需要保持INTERACT_ACROSS_USERS权限。

您必须持有BROADCAST_STICKY权限才能使用此API。 如果您未获得该权限，则会抛出SecurityException 。

revokeUriPermission

void revokeUriPermission (Uri uri, 
                int modeFlags)

删除所有权限以访问之前与grantUriPermission(String, Uri, int)一起添加的特定内容提供商Uri。 给定的Uri将匹配所有先前授予的Uris，这些Uris与给定的Uri是相同的或者是子路径。 也就是说，撤销“content：// foo / target”将撤消“content：// foo / target”和“content：// foo / target / sub”，但不会取消“content：// foo”。 它不会删除存在于更高级别的任何前缀授权。

在LOLLIPOP之前，如果您没有经常访问Uri的权限，但通过特定的Uri权限授予获得访问权限，则无法使用此功能撤消该授权，并且会抛出SecurityException 。 从LOLLIPOP ，这个函数不会抛出一个安全异常，但会删除Uri给予应用程序的任何权限（或者没有）。

sendBroadcast

void sendBroadcast (Intent intent, 
                String receiverPermission)

将给定的意图广播给所有感兴趣的BroadcastReceivers，允许强制执行可选的必需权限。 这个调用是异步的; 它会立即返回，并且您将在接收器运行时继续执行。 没有结果从接收器传播，接收器不能中止广播。 如果您想允许接收者传播结果或中止广播，则必须使用sendOrderedBroadcast(Intent, String)发送一个有序广播。

有关意向广播的更多信息，请参阅 BroadcastReceiver 。

sendBroadcast

void sendBroadcast (Intent intent)

将给定的意图广播给所有感兴趣的BroadcastReceivers。 这个调用是异步的; 它会立即返回，并且您将在接收器运行时继续执行。 没有结果从接收器传播，接收器不能中止广播。 如果您想允许接收者传播结果或中止广播，则必须使用sendOrderedBroadcast(Intent, String)发送一个有序广播。

有关意向广播的更多信息，请参阅 BroadcastReceiver 。

sendBroadcastAsUser

void sendBroadcastAsUser (Intent intent, 
                UserHandle user)

版本sendBroadcast(Intent) ，允许您指定广播将发送到的用户。 这不适用于系统映像上未预安装的应用程序。 使用它需要保持INTERACT_ACROSS_USERS权限。

sendBroadcastAsUser

void sendBroadcastAsUser (Intent intent, 
                UserHandle user, 
                String receiverPermission)

版本sendBroadcast(Intent, String) ，允许您指定广播将发送到的用户。 这不适用于系统映像上未预安装的应用程序。 使用它需要保持INTERACT_ACROSS_USERS权限。

sendOrderedBroadcast

void sendOrderedBroadcast (Intent intent, 
                String receiverPermission, 
                BroadcastReceiver resultReceiver, 
                Handler scheduler, 
                int initialCode, 
                String initialData, 
                Bundle initialExtras)

版本sendBroadcast(Intent) ，允许您从广播接收数据。 这是通过提供调用当你自己的广播接收器，这将在广播结束被视为最后的接收器实现-它onReceive(Context, Intent)方法将与来自其它接收器收集到的结果值被调用。 广播将按照与拨打sendOrderedBroadcast(Intent, String)相同的方式进行序列化。

像sendBroadcast(Intent)一样，这种方法是异步的; 它会在调用resultReceiver.onReceive（）之前返回。

有关意向广播的更多信息，请参阅 BroadcastReceiver 。

sendOrderedBroadcast

void sendOrderedBroadcast (Intent intent, 
                String receiverPermission)

将给定的意图广播给所有感兴趣的BroadcastReceivers，一次发送一个，让更多的首选接收者在将广播发送给次优先接收者之前消费广播。 这个调用是异步的; 它会立即返回，并且您将在接收器运行时继续执行。

有关意向广播的更多信息，请参阅 BroadcastReceiver 。

sendOrderedBroadcastAsUser

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) ，它允许您指定广播将被发送到的用户。 这不适用于系统映像上未预安装的应用程序。 使用它需要保持INTERACT_ACROSS_USERS权限。

有关意向广播的更多信息，请参阅 BroadcastReceiver 。

sendStickyBroadcast

void sendStickyBroadcast (Intent intent)

此方法已弃用。
不应使用粘滞广播。 它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。 推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。

执行“sticky”的sendBroadcast(Intent) ，这意味着您发送的Intent在广播完成后仍然保留，以便其他人可以通过返回值registerReceiver(BroadcastReceiver, IntentFilter)快速检索该数据。 在所有其他方面，这与sendBroadcast(Intent)行为相同。

您必须持有BROADCAST_STICKY权限才能使用此API。 如果您未获得该权限，则会抛出SecurityException 。

sendStickyBroadcastAsUser

void sendStickyBroadcastAsUser (Intent intent, 
                UserHandle user)

此方法已弃用。
不应使用粘滞广播。 它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。 推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。

版本sendStickyBroadcast(Intent) ，允许您指定广播将发送到的用户。 这不适用于系统映像上未预安装的应用程序。 使用它需要保持INTERACT_ACROSS_USERS权限。

sendStickyOrderedBroadcast

void sendStickyOrderedBroadcast (Intent intent, 
                BroadcastReceiver resultReceiver, 
                Handler scheduler, 
                int initialCode, 
                String initialData, 
                Bundle initialExtras)

此方法已弃用。
不应使用粘滞广播。 它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。 推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。

版本sendStickyBroadcast(Intent) ，允许您从广播接收数据。 这是通过在呼叫时提供您自己的BroadcastReceiver来实现的，这将在广播结束时作为最终接收者处理 - 它的onReceive(Context, Intent)方法将使用从其他接收者收集的结果值进行调用。 广播将按照与拨打sendOrderedBroadcast(Intent, String)相同的方式进行序列化。

像sendBroadcast(Intent)一样，这种方法是异步的; 它会在调用resultReceiver.onReceive（）之前返回。 请注意，存储的粘性数据只是您最初提供给广播的数据，而不是接收机所做的任何更改。

有关意向广播的更多信息，请参阅 BroadcastReceiver 。

sendStickyOrderedBroadcastAsUser

void sendStickyOrderedBroadcastAsUser (Intent intent, 
                UserHandle user, 
                BroadcastReceiver resultReceiver, 
                Handler scheduler, 
                int initialCode, 
                String initialData, 
                Bundle initialExtras)

此方法已弃用。
不应使用粘滞广播。 它们不提供安全性（任何人都可以访问它们），没有保护（任何人都可以修改它们）以及其他许多问题。 推荐的模式是使用非粘性广播来报告某些事情已经发生变化，另一种机制是应用程序在需要时检索当前值。

版本sendStickyOrderedBroadcast(Intent, BroadcastReceiver, Handler, int, String, Bundle) ，允许您指定广播将被发送到的用户。 这不适用于系统映像上未预安装的应用程序。 使用它需要保持INTERACT_ACROSS_USERS权限。

有关意向广播的更多信息，请参阅 BroadcastReceiver 。

setTheme

void setTheme (int resid)

为此上下文设置基本主题。 请注意，应在上下文中实例化任何视图之前调用setContentView(View) （例如，在调用setContentView(View)或inflate(int, ViewGroup)之前）。

setWallpaper

void setWallpaper (Bitmap bitmap)

此方法已弃用。
改为使用WallpaperManager.set() 。

此方法要求调用方拥有权限 SET_WALLPAPER 。

setWallpaper

void setWallpaper (InputStream data)

此方法已弃用。
改为使用WallpaperManager.set() 。

此方法要求调用方拥有权限 SET_WALLPAPER 。

startActivities

void startActivities (Intent[] intents, 
                Bundle options)

启动多项新活动。 这通常与针对数组中的第一个Intent调用startActivity(Intent)相同，在其创建过程中为该活动调用startActivity(Intent)用于第二个条目等。请注意，与该方法不同，通常不会创建除数组中最后一个活动在这一点上，而是会在用户第一次访问它们时创建（由于顶部的活动被压回）。

如果没有找到任何给定Intent的活动，则此方法将引发ActivityNotFoundException 。 在这种情况下，活动堆栈的状态是未定义的（列表中的一些Intents可能在其上，有些则不），所以您可能想要避免这种情况。

startActivities

void startActivities (Intent[] intents)

与没有指定选项的 startActivities(Intent[], Bundle)相同。

startActivity

void startActivity (Intent intent)

与没有指定选项的 startActivity(Intent, Bundle)相同。

startActivity

void startActivity (Intent intent, 
                Bundle options)

启动一项新活动。 您不会收到有关活动何时退出的任何信息。

请注意，如果从Activity上下文之外调用此方法，那么意图必须包含FLAG_ACTIVITY_NEW_TASK启动标志。 这是因为，如果没有从现有的活动启动，就没有现有的任务来放置新的活动，因此需要将其放置在它自己的单独任务中。

如果没有发现运行给定Intent的Activity，则此方法将引发 ActivityNotFoundException 。

startInstrumentation

boolean startInstrumentation (ComponentName className, 
                String profileFile, 
                Bundle arguments)

开始执行一个Instrumentation类。 给定的Instrumentation组件将通过杀死其目标应用程序（如果当前正在运行），启动目标进程，实例化Instrumentation组件，然后让它驱动应用程序来运行。

该功能不是同步的 - 只要仪器启动并且正在运行，它就会返回。

通常只允许针对未签名或使用签名进行签名的软件包运行测试，该签名中还会签署该测试软件包（确保目标相信该测试）。

startIntentSender

void startIntentSender (IntentSender intent, 
                Intent fillInIntent, 
                int flagsMask, 
                int flagsValues, 
                int extraFlags)

与没有指定选项的 startIntentSender(IntentSender, Intent, int, int, int, Bundle)相同。

startIntentSender

void startIntentSender (IntentSender intent, 
                Intent fillInIntent, 
                int flagsMask, 
                int flagsValues, 
                int extraFlags, 
                Bundle options)

像startActivity(Intent, Bundle)一样，但需要启动一个IntentSender。 如果IntentSender用于某项活动，那么该活动将开始，就像您在此调用常规startActivity(Intent) ; 否则，它的相关操作将被执行（例如发送广播），就好像你已经调用了IntentSender.sendIntent一样。

startService

ComponentName startService (Intent service)

请求启动给定的应用程序服务。 Intent应该包含要启动的特定服务实现的完整类名称或要包含的特定包名称。 如果未指定Intent，则会记录有关此信息的警告，以及它找到并使用的多个匹配服务中的哪一个将是未定义的。 如果此服务尚未运行，它将被实例化并启动（如果需要，将为其创建一个进程）; 如果它正在运行，那么它仍然在运行。

这种方法每次调用会导致相应的调用目标服务的onStartCommand(Intent, int, int)方法，这里给出的意图 。 这提供了一种便捷的方式将作业提交给服务，而无需绑定并调用其接口。

使用startService（）将覆盖由bindService(Intent, ServiceConnection, int)管理的默认服务生命周期：它要求服务保持运行，直到stopService(Intent) ，而不管是否有任何客户端连接到该服务。 请注意，对startService（）的调用不是嵌套：无论您调用startService（）多少次，只需对stopService(Intent)进行一次调用即可停止它。

系统尽可能地尝试保持运行服务。 他们应该停止的唯一时间是当前的前台应用程序正在使用如此多的资源以致服务需要被终止。 如果服务进程中发生任何错误，它将自动重新启动。

如果您没有启动给定服务的权限，则此函数将抛出 SecurityException 。

注意：每次调用startService（）都会导致系统完成重要工作，以管理意图处理周围的服务生命周期，这可能需要几毫秒的CPU时间。 由于这一成本，startService（）不应该用于频繁的意图传递到服务，并且仅用于安排重要的工作。 使用bound services进行高频呼叫。

stopService

boolean stopService (Intent service)

请求停止给定的应用程序服务。 如果服务未运行，则不会发生任何事情。 否则它会停止。 请注意，对startService（）的调用不计入 - 无论启动多少次，都会停止服务。

请注意，如果停止服务仍然有ServiceConnection绑定到它与对象BIND_AUTO_CREATE集，它不会被破坏，直到所有这些绑定被删除。 有关服务生命周期的更多详细信息，请参阅Service文档。

如果您没有停止给定服务的权限，则此函数将抛出 SecurityException 。

unbindService

void unbindService (ServiceConnection conn)

断开应用程序服务。 随着服务重新启动，您将不再接收呼叫，现在可以随时停止服务。

unregisterReceiver

void unregisterReceiver (BroadcastReceiver receiver)

取消注册以前注册的BroadcastReceiver。 所有为此BroadcastReceiver注册的过滤器都将被删除。