Most visited

Recently visited

Results for

Added in API level 14

VpnService

public class VpnService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.net.VpnService

VpnService是应用程序扩展和构建自己的VPN解决方案的基类。通常，它会创建一个虚拟网络接口，配置地址和路由规则，并将文件描述符返回给应用程序。从描述符读取的每一个信息都会检索发送到接口的传出数据包。每次写入描述符都会像接收到的接口一样注入传入的数据包。该接口在Internet协议（IP）上运行，因此数据包始终以IP标头开始。然后，应用程序通过隧道处理和与远程服务器交换数据包来完成VPN连接。

让应用程序拦截数据包引发了巨大的安全问题。 VPN应用程序很容易破坏网络。此外，他们中的两人可能会相互冲突。系统采取几项行动来解决这些问题。这里有一些关键点：

User action is required the first time an application creates a VPN connection.
There can be only one VPN connection running at the same time. The existing interface is deactivated when a new one is created.
A system-managed notification is shown during the lifetime of a VPN connection.
A system-managed dialog gives the information of the current VPN connection. It also provides a button to disconnect.
The network is restored automatically when the file descriptor is closed. It also covers the cases when a VPN application is crashed or killed by the system.

这个类有两种主要方法： prepare(Context)和establish() 。前者处理用户操作并停止由另一个应用程序创建的VPN连接。后者使用提供给VpnService.Builder的参数创建一个VPN接口。申请必须致电prepare(Context)授予在该课程中使用其他方法的权利，并且该权利可以在任何时候被撤销。以下是创建VPN连接的一般步骤：

When the user presses the button to connect, call prepare(Context) and launch the returned intent, if non-null.
When the application becomes prepared, start the service.
Create a tunnel to the remote server and negotiate the network parameters for the VPN connection.
Supply those parameters to a VpnService.Builder and create a VPN interface by calling establish().
Process and exchange packets between the tunnel and the returned file descriptor.
When onRevoke() is invoked, close the file descriptor and shut down the tunnel gracefully.

扩展这个类的服务需要用适当的权限和意图过滤器声明。他们的访问必须通过BIND_VPN_SERVICE权限进行保护，而他们的意图过滤器必须与SERVICE_INTERFACE操作匹配。以下是在AndroidManifest.xml中声明VPN服务的AndroidManifest.xml ：

 <service android:name=".ExampleVpnService"
         android:permission="android.permission.BIND_VPN_SERVICE">
     <intent-filter>
         <action android:name="android.net.VpnService"/>
     </intent-filter>
 </service>

也可以看看：

VpnService.Builder

Summary

Nested classes
`class`	`VpnService.Builder` Helper类创建一个VPN接口。

Constants
`String`	`SERVICE_INTERFACE` 该操作必须与该服务的意图过滤器匹配。

Inherited constants

From class android.app.Service

From class android.content.Context

From interface android.content.ComponentCallbacks2

Public constructors
`VpnService()`

Public methods
`IBinder`	`onBind(Intent intent)` 将通信接口返回到服务。
`void`	`onRevoke()` 当应用程序被撤销时调用。
`static Intent`	`prepare(Context context)` 准备建立VPN连接。
`boolean`	`protect(Socket socket)` 便捷的方法来保护 `Socket`免受VPN连接。
`boolean`	`protect(int socket)` 保护VPN连接的套接字。
`boolean`	`protect(DatagramSocket socket)` 便捷方法来保护 `DatagramSocket`免受VPN连接。
`boolean`	`setUnderlyingNetworks(Network[] networks)` 设置VPN为其上游连接使用的底层网络。

Inherited methods

From class android.app.Service

`void`	`dump(FileDescriptor fd, PrintWriter writer, String[] args)` 将服务的状态打印到给定的流中。
`final Application`	`getApplication()` 返回拥有此服务的应用程序。
`abstract IBinder`	`onBind(Intent intent)` 将通信信道返回给服务。
`void`	`onConfigurationChanged(Configuration newConfig)` 设备配置在组件运行时发生更改时由系统调用。
`void`	`onCreate()` 服务第一次创建时由系统调用。
`void`	`onDestroy()` 由系统调用以通知服务它已不再使用并正在被删除。
`void`	`onLowMemory()` 这在整个系统内存不足时调用，并且主动运行的进程应该修剪内存使用情况。
`void`	`onRebind(Intent intent)` 当新客户端连接到服务时调用，之前它已被通知所有已断开其 `onUnbind(Intent)` 。
`void`	`onStart(Intent intent, int startId)` 此方法在API级别5中已弃用。 `onStartCommand(Intent, int, int)`改为执行`onStartCommand(Intent, int, int)` 。
`int`	`onStartCommand(Intent intent, int flags, int startId)` 每当客户端通过调用 `startService(Intent)`显式启动服务时，由系统调用，提供它提供的参数以及代表启动请求的唯一整数标记。
`void`	`onTaskRemoved(Intent rootIntent)` 如果服务当前正在运行并且用户已经删除了来自服务应用程序的任务，则会调用该服务。
`void`	`onTrimMemory(int level)` 当操作系统确定进程从其进程中删除不需要的内存是一个好时机时调用。
`boolean`	`onUnbind(Intent intent)` 当所有客户端与服务发布的特定接口断开连接时调用。
`final void`	`startForeground(int id, Notification notification)` 使该服务在前台运行，提供正在进行的通知，以便在此状态下向用户显示。
`final void`	`stopForeground(int flags)` 从前台状态中删除此服务，如果需要更多内存，则允许它被终止。
`final void`	`stopForeground(boolean removeNotification)` 同义词为 `stopForeground(int)` 。
`final void`	`stopSelf()` 停止服务，如果它以前开始。
`final void`	`stopSelf(int startId)` 旧版本的 `stopSelfResult(int)`不返回结果。
`final boolean`	`stopSelfResult(int startId)` 如果最近一次启动的时间是 `startId，请`停止服务。

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.content.ComponentCallbacks2

From interface android.content.ComponentCallbacks

Constants

SERVICE_INTERFACE

Added in API level 14

String SERVICE_INTERFACE

该操作必须与该服务的意图过滤器匹配。它还需要BIND_VPN_SERVICE权限，以便其他应用程序不能滥用它。

常量值：“android.net.VpnService”

Public constructors

VpnService

Added in API level 14

VpnService ()

Public methods

onBind

Added in API level 14

IBinder onBind (Intent intent)

将通信接口返回到服务。除SERVICE_INTERFACE操作外，此方法返回null上的Intent 。覆盖此方法的应用程序必须识别意图并相应地返回相应的接口。

Parameters
`intent`	`Intent`: The Intent that was used to bind to this service, as given to `Context.bindService`. Note that any extras that were included with the Intent at that point will not be seen here.

Returns
`IBinder`	Return an IBinder through which clients can call on to the service.

也可以看看：

onBind(Intent)

onRevoke

Added in API level 14

void onRevoke ()

当应用程序被撤销时调用。此时，VPN接口已被系统停用。应用程序应关闭文件描述符并正常关闭。此方法的默认实现是调用stopSelf() 。

调用此方法可能不会发生在进程的主线程上。

也可以看看：

prepare(Context)

prepare

Added in API level 14

Intent prepare (Context context)

准备建立VPN连接。如果VPN应用程序已准备好或用户以前已同意VPN应用程序，则此方法返回null 。否则，它会将Intent返回给系统活动。应用程序应该使用startActivityForResult(Intent, int)启动该活动以自行准备。该活动可能会弹出一个对话框以要求用户采取行动，结果将通过onActivityResult(int, int, Intent) 。如果结果为RESULT_OK ，则应用程序已准备好并被授予使用此类中的其他方法的权限。

只能同时授予一个应用程序。当另一个应用程序被授予时，权利被撤销。失去权利的申请将通过其onRevoke()通知。除非它再次准备好，否则后续对此类中其他方法的调用将失败。

用户可以在激活时随时禁用VPN，在这种情况下，此方法将在下一次执行时返回意图，以再次获得用户的同意。

Parameters
`context`	`Context`

Returns
`Intent`

也可以看看：

onRevoke()

protect

Added in API level 14

boolean protect (Socket socket)

便捷方法来保护 Socket免受VPN连接。

Parameters
`socket`	`Socket`

Returns
`boolean`	`true` on success.

也可以看看：

protect(int)

protect

Added in API level 14

boolean protect (int socket)

保护VPN连接的套接字。保护后，通过此套接字发送的数据将直接进入底层网络，因此其流量不会通过VPN转发。如果某些连接需要保留在VPN外部，此方法非常有用。例如，VPN隧道应该保护自己，如果其目的地被VPN路由覆盖。否则，它的传出数据包将被发回到VPN接口并导致无限循环。如果应用程序未准备好或被吊销，此方法将失败。

该套接字不是通过此方法关闭的。

Parameters
`socket`	`int`

Returns
`boolean`	`true` on success.

protect

Added in API level 14

boolean protect (DatagramSocket socket)

便捷方法来保护 DatagramSocket免受VPN连接。

Parameters
`socket`	`DatagramSocket`

Returns
`boolean`	`true` on success.

也可以看看：

protect(int)

setUnderlyingNetworks

Added in API level 22

boolean setUnderlyingNetworks (Network[] networks)

设置VPN为其上游连接使用的底层网络。

系统使用它来了解传送受此VPN影响的应用流量的实际网络，以便向用户呈现此信息（例如，通过状态栏图标）。

此方法只需要“，如插座（多个）传递到被调用如果VPN已显式绑定其底层通信信道的€ protect(int) €”到Network使用API诸如bindSocket(Socket)或bindSocket(DatagramSocket) 。 Network它使用的Network组发生更改时，VPN应该调用此方法。

networks是以下之一：

a non-empty array: an array of one or more Networks, in decreasing preference order. For example, if this VPN uses both wifi and mobile (cellular) networks to carry app traffic, but prefers or uses wifi more than mobile, wifi should appear first in the array.
an empty array: a zero-element array, meaning that the VPN has no underlying network connection, and thus, app traffic will not be sent or received.
null: (default) signifies that the VPN uses whatever is the system's default network. I.e., it doesn't use the bindSocket or bindDatagramSocket APIs mentioned above to send traffic over specific channels.

只有在VPN当前建立的情况下，此呼叫才会成功。有关尚未建立VPN的设置，请参阅setUnderlyingNetworks(Network[]) 。

Parameters
`networks`	`Network`: An array of networks the VPN uses to tunnel traffic to/from its servers.

Returns
`boolean`	`true` on success.

Interfaces

Classes

Enums

Exceptions

Most visited

Recently visited

Results for

VpnService

Summary

Nested classes

Constants

Inherited constants

Public constructors

Public methods

Inherited methods

Constants

SERVICE_INTERFACE

Public constructors

VpnService

Public methods

onBind

onRevoke

prepare

protect

protect

protect

setUnderlyingNetworks