Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/net/VpnService.Builder#pubctors) \| [Methods](https://developer.android.com/reference/android/net/VpnService.Builder#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/net/VpnService.Builder#inhmethods)

# VpnService.Builder

*** ** * ** ***


`
public


class
VpnService.Builder
`


`

extends https://developer.android.com/reference/java/lang/Object


`

`


`

|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.net.VpnService.Builder |

<br />

*** ** * ** ***

Helper class to create a VPN interface. This class should be always
used within the scope of the outer `https://developer.android.com/reference/android/net/VpnService`.
**See also:**

- `https://developer.android.com/reference/android/net/VpnService`

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/net/VpnService.Builder#Builder()() ` |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addAddress(java.net.InetAddress,%20int)(https://developer.android.com/reference/java/net/InetAddress address, int prefixLength) ` Add a network address to the VPN interface. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addAddress(java.lang.String,%20int)(https://developer.android.com/reference/java/lang/String address, int prefixLength) ` Convenience method to add a network address to the VPN interface using a numeric address string. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addAllowedApplication(java.lang.String)(https://developer.android.com/reference/java/lang/String packageName) ` Adds an application that's allowed to access the VPN connection. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addDisallowedApplication(java.lang.String)(https://developer.android.com/reference/java/lang/String packageName) ` Adds an application that's denied access to the VPN connection. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addDnsServer(java.lang.String)(https://developer.android.com/reference/java/lang/String address) ` Convenience method to add a DNS server to the VPN connection using a numeric address string. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addDnsServer(java.net.InetAddress)(https://developer.android.com/reference/java/net/InetAddress address) ` Add a DNS server to the VPN connection. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addRoute(android.net.IpPrefix)(https://developer.android.com/reference/android/net/IpPrefix prefix) ` Add a network route to the VPN interface. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addRoute(java.net.InetAddress,%20int)(https://developer.android.com/reference/java/net/InetAddress address, int prefixLength) ` Add a network route to the VPN interface. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addRoute(java.lang.String,%20int)(https://developer.android.com/reference/java/lang/String address, int prefixLength) ` Convenience method to add a network route to the VPN interface using a numeric address string. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#addSearchDomain(java.lang.String)(https://developer.android.com/reference/java/lang/String domain) ` Add a search domain to the DNS resolver. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#allowBypass()() ` Allows all apps to bypass this VPN connection. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#allowFamily(int)(int family) ` Allows traffic from the specified address family. |
| ` https://developer.android.com/reference/android/os/ParcelFileDescriptor` | ` https://developer.android.com/reference/android/net/VpnService.Builder#establish()() ` Create a VPN interface using the parameters supplied to this builder. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#excludeRoute(android.net.IpPrefix)(https://developer.android.com/reference/android/net/IpPrefix prefix) ` Exclude a network route from the VPN interface. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#setBlocking(boolean)(boolean blocking) ` Sets the VPN interface's file descriptor to be in blocking/non-blocking mode. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#setConfigureIntent(android.app.PendingIntent)(https://developer.android.com/reference/android/app/PendingIntent intent) ` Set the `https://developer.android.com/reference/android/app/PendingIntent` to an activity for users to configure the VPN connection. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#setHttpProxy(android.net.ProxyInfo)(https://developer.android.com/reference/android/net/ProxyInfo proxyInfo) ` Sets an HTTP proxy for the VPN network. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#setMetered(boolean)(boolean isMetered) ` Marks the VPN network as metered. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#setMtu(int)(int mtu) ` Set the maximum transmission unit (MTU) of the VPN interface. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#setSession(java.lang.String)(https://developer.android.com/reference/java/lang/String session) ` Set the name of this session. |
| ` https://developer.android.com/reference/android/net/VpnService.Builder` | ` https://developer.android.com/reference/android/net/VpnService.Builder#setUnderlyingNetworks(android.net.Network[])(https://developer.android.com/reference/android/net/Network networks) ` Sets the underlying networks used by the VPN for its upstream connections. |

| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class<?>` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||

## Public constructors

### Builder

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Builder ()
```

<br />

<br />

## Public methods

### addAddress

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addAddress (InetAddress address, 
                int prefixLength)
```

Add a network address to the VPN interface. Both IPv4 and IPv6
addresses are supported. At least one address must be set before
calling `https://developer.android.com/reference/android/net/VpnService.Builder#establish()`.

Adding an address implicitly allows traffic from that address family
(i.e., IPv4 or IPv6) to be routed over the VPN. @see #allowFamily

<br />

| Parameters ||
|---|---|
| `address` | `InetAddress`: This value cannot be `null`. <br /> |
| `prefixLength` | `int` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the address is invalid. |

### addAddress

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addAddress (String address, 
                int prefixLength)
```

Convenience method to add a network address to the VPN interface
using a numeric address string. See `https://developer.android.com/reference/java/net/InetAddress` for the
definitions of numeric address formats.

Adding an address implicitly allows traffic from that address family
(i.e., IPv4 or IPv6) to be routed over the VPN. @see #allowFamily

<br />

| Parameters ||
|---|---|
| `address` | `String`: This value cannot be `null`. <br /> |
| `prefixLength` | `int` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the address is invalid. |

**See also:**

- `https://developer.android.com/reference/android/net/VpnService.Builder#addAddress(java.net.InetAddress,%20int)`

### addAllowedApplication

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addAllowedApplication (String packageName)
```

Adds an application that's allowed to access the VPN connection.

If this method is called at least once, only applications added through this method (and
no others) are allowed access. Else (if this method is never called), all applications
are allowed by default. If some applications are added, other, un-added applications
will use networking as if the VPN wasn't running.

A `https://developer.android.com/reference/android/net/VpnService.Builder` may have only a set of allowed applications OR a set of disallowed
ones, but not both. Calling this method after `https://developer.android.com/reference/android/net/VpnService.Builder#addDisallowedApplication(java.lang.String)` has
already been called, or vice versa, will throw an `https://developer.android.com/reference/java/lang/UnsupportedOperationException`.

`packageName` must be the canonical name of a currently installed application.
`https://developer.android.com/reference/android/content/pm/PackageManager.NameNotFoundException` is thrown if there's no such application.

<br />

| Parameters ||
|---|---|
| `packageName` | `String`: The full name (e.g.: "com.google.apps.contacts") of an application. This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | this `https://developer.android.com/reference/android/net/VpnService.Builder` object to facilitate chaining method calls. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/android/content/pm/PackageManager.NameNotFoundException` | If the application isn't installed. |

### addDisallowedApplication

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addDisallowedApplication (String packageName)
```

Adds an application that's denied access to the VPN connection.

By default, all applications are allowed access, except for those denied through this
method. Denied applications will use networking as if the VPN wasn't running.

A `https://developer.android.com/reference/android/net/VpnService.Builder` may have only a set of allowed applications OR a set of disallowed
ones, but not both. Calling this method after `https://developer.android.com/reference/android/net/VpnService.Builder#addAllowedApplication(java.lang.String)` has already
been called, or vice versa, will throw an `https://developer.android.com/reference/java/lang/UnsupportedOperationException`.

`packageName` must be the canonical name of a currently installed application.
`https://developer.android.com/reference/android/content/pm/PackageManager.NameNotFoundException` is thrown if there's no such application.

<br />

| Parameters ||
|---|---|
| `packageName` | `String`: The full name (e.g.: "com.google.apps.contacts") of an application. This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | this `https://developer.android.com/reference/android/net/VpnService.Builder` object to facilitate chaining method calls. This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/android/content/pm/PackageManager.NameNotFoundException` | If the application isn't installed. |

### addDnsServer

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addDnsServer (String address)
```

Convenience method to add a DNS server to the VPN connection
using a numeric address string. See `https://developer.android.com/reference/java/net/InetAddress` for the
definitions of numeric address formats.

Adding a server implicitly allows traffic from that address family
(i.e., IPv4 or IPv6) to be routed over the VPN. @see #allowFamily

<br />

| Parameters ||
|---|---|
| `address` | `String`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the address is invalid. |

**See also:**

- `https://developer.android.com/reference/android/net/VpnService.Builder#addDnsServer(java.net.InetAddress)`

### addDnsServer

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addDnsServer (InetAddress address)
```

Add a DNS server to the VPN connection. Both IPv4 and IPv6
addresses are supported. If none is set, the DNS servers of
the default network will be used.

Adding a server implicitly allows traffic from that address family
(i.e., IPv4 or IPv6) to be routed over the VPN. @see #allowFamily

<br />

| Parameters ||
|---|---|
| `address` | `InetAddress`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the address is invalid. |

### addRoute

Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addRoute (IpPrefix prefix)
```

Add a network route to the VPN interface. Both IPv4 and IPv6
routes are supported.

Adding a route implicitly allows traffic from that address family
(i.e., IPv4 or IPv6) to be routed over the VPN. @see #allowFamily

Calling this method overrides previous calls to `https://developer.android.com/reference/android/net/VpnService.Builder#excludeRoute(android.net.IpPrefix)` for the same
destination.

If multiple routes match the packet destination, route with the longest prefix takes
precedence.

<br />

| Parameters ||
|---|---|
| `prefix` | `IpPrefix`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the route is invalid. |

### addRoute

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addRoute (InetAddress address, 
                int prefixLength)
```

Add a network route to the VPN interface. Both IPv4 and IPv6
routes are supported.

Adding a route implicitly allows traffic from that address family
(i.e., IPv4 or IPv6) to be routed over the VPN. @see #allowFamily

Calling this method overrides previous calls to `https://developer.android.com/reference/android/net/VpnService.Builder#excludeRoute(android.net.IpPrefix)` for the same
destination.

If multiple routes match the packet destination, route with the longest prefix takes
precedence.

<br />

| Parameters ||
|---|---|
| `address` | `InetAddress`: This value cannot be `null`. <br /> |
| `prefixLength` | `int` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the route is invalid. |

### addRoute

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addRoute (String address, 
                int prefixLength)
```

Convenience method to add a network route to the VPN interface
using a numeric address string. See `https://developer.android.com/reference/java/net/InetAddress` for the
definitions of numeric address formats.

Adding a route implicitly allows traffic from that address family
(i.e., IPv4 or IPv6) to be routed over the VPN. @see #allowFamily

Calling this method overrides previous calls to `https://developer.android.com/reference/android/net/VpnService.Builder#excludeRoute(android.net.IpPrefix)` for the same
destination.

If multiple routes match the packet destination, route with the longest prefix takes
precedence.

<br />

| Parameters ||
|---|---|
| `address` | `String`: This value cannot be `null`. <br /> |
| `prefixLength` | `int` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the route is invalid. |

**See also:**

- `https://developer.android.com/reference/android/net/VpnService.Builder#addRoute(java.net.InetAddress,%20int)`

### addSearchDomain

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder addSearchDomain (String domain)
```

Add a search domain to the DNS resolver.

<br />

| Parameters ||
|---|---|
| `domain` | `String`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

### allowBypass

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder allowBypass ()
```

Allows all apps to bypass this VPN connection.

By default, all traffic from apps is forwarded through the VPN interface and it is not
possible for apps to side-step the VPN. If this method is called, apps may use methods
such as `https://developer.android.com/reference/android/net/ConnectivityManager#bindProcessToNetwork(android.net.Network)` to instead send/receive
directly over the underlying network or any other network they have permissions for.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | this `https://developer.android.com/reference/android/net/VpnService.Builder` object to facilitate chaining of method calls. This value cannot be `null`. <br /> |

### allowFamily

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder allowFamily (int family)
```

Allows traffic from the specified address family.

By default, if no address, route or DNS server of a specific family (IPv4 or IPv6) is
added to this VPN, then all outgoing traffic of that family is blocked. If any address,
route or DNS server is added, that family is allowed.

This method allows an address family to be unblocked even without adding an address,
route or DNS server of that family. Traffic of that family will then typically
fall-through to the underlying network if it's supported.

`family` must be either `AF_INET` (for IPv4) or `AF_INET6` (for IPv6).
`https://developer.android.com/reference/java/lang/IllegalArgumentException` is thrown if it's neither.

<br />

| Parameters ||
|---|---|
| `family` | `int`: The address family (`AF_INET` or `AF_INET6`) to allow. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | this `https://developer.android.com/reference/android/net/VpnService.Builder` object to facilitate chaining of method calls. This value cannot be `null`. <br /> |

### establish

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public ParcelFileDescriptor establish ()
```

Create a VPN interface using the parameters supplied to this
builder. The interface works on IP packets, and a file descriptor
is returned for the application to access them. Each read
retrieves an outgoing packet which was routed to the interface.
Each write injects an incoming packet just like it was received
from the interface. The file descriptor is put into non-blocking
mode by default to avoid blocking Java threads. To use the file
descriptor completely in native space, see
`https://developer.android.com/reference/android/os/ParcelFileDescriptor#detachFd()`. The application MUST
close the file descriptor when the VPN connection is terminated.
The VPN interface will be removed and the network will be
restored by the system automatically.

To avoid conflicts, there can be only one active VPN interface
at the same time. Usually network parameters are never changed
during the lifetime of a VPN connection. It is also common for an
application to create a new file descriptor after closing the
previous one. However, it is rare but not impossible to have two
interfaces while performing a seamless handover. In this case, the
old interface will be deactivated when the new one is created
successfully. Both file descriptors are valid but now outgoing
packets will be routed to the new interface. Therefore, after
draining the old file descriptor, the application MUST close it
and start using the new file descriptor. If the new interface
cannot be created, the existing interface and its file descriptor
remain untouched.

An exception will be thrown if the interface cannot be created
for any reason. However, this method returns `null` if the
application is not prepared or is revoked. This helps solve
possible race conditions between other VPN applications.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/os/ParcelFileDescriptor` | `https://developer.android.com/reference/android/os/ParcelFileDescriptor` of the VPN interface, or `null` if the application is not prepared. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if a parameter is not accepted by the operating system. |
| `https://developer.android.com/reference/java/lang/IllegalStateException` | if a parameter cannot be applied by the operating system. |
| `https://developer.android.com/reference/java/lang/SecurityException` | if the service is not properly declared in `AndroidManifest.xml`. |

**See also:**

- `https://developer.android.com/reference/android/net/VpnService`

### excludeRoute

Added in [API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder excludeRoute (IpPrefix prefix)
```

Exclude a network route from the VPN interface. Both IPv4 and IPv6
routes are supported.

Calling this method overrides previous calls to `https://developer.android.com/reference/android/net/VpnService.Builder#addRoute(android.net.IpPrefix)` for the same
destination.

If multiple routes match the packet destination, route with the longest prefix takes
precedence.

<br />

| Parameters ||
|---|---|
| `prefix` | `IpPrefix`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the route is invalid. |

### setBlocking

Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder setBlocking (boolean blocking)
```

Sets the VPN interface's file descriptor to be in blocking/non-blocking mode.

By default, the file descriptor returned by `https://developer.android.com/reference/android/net/VpnService.Builder#establish()` is non-blocking.

<br />

| Parameters ||
|---|---|
| `blocking` | `boolean`: True to put the descriptor into blocking mode; false for non-blocking. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | this `https://developer.android.com/reference/android/net/VpnService.Builder` object to facilitate chaining method calls. This value cannot be `null`. <br /> |

### setConfigureIntent

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder setConfigureIntent (PendingIntent intent)
```

Set the `https://developer.android.com/reference/android/app/PendingIntent` to an activity for users to
configure the VPN connection. If it is not set, the button
to configure will not be shown in system-managed dialogs.

<br />

| Parameters ||
|---|---|
| `intent` | `PendingIntent`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

### setHttpProxy

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder setHttpProxy (ProxyInfo proxyInfo)
```

Sets an HTTP proxy for the VPN network.

This proxy is only a recommendation and it is possible that some apps
will ignore it.

PAC proxies are not supported over VPNs.

Apps that do use the proxy cannot distinguish between routes handled
and not handled by the VPN and will try to access HTTP resources over the proxy
regardless of the destination. In practice this means using a proxy with a split
tunnel generally won't work as expected, because HTTP accesses on routes not handled by
the VPN will not reach as the proxy won't be available outside of the VPN network.

<br />

| Parameters ||
|---|---|
| `proxyInfo` | `ProxyInfo`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

### setMetered

Added in [API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder setMetered (boolean isMetered)
```

Marks the VPN network as metered. A VPN network is classified as metered when the user is
sensitive to heavy data usage due to monetary costs and/or data limitations. In such
cases, you should set this to `true` so that apps on the system can avoid doing
large data transfers. Otherwise, set this to `false`. Doing so would cause VPN
network to inherit its meteredness from its underlying networks.

VPN apps targeting `https://developer.android.com/reference/android/os/Build.VERSION_CODES#Q` or above will be
considered metered by default.

<br />

| Parameters ||
|---|---|
| `isMetered` | `boolean`: `true` if VPN network should be treated as metered regardless of underlying network meteredness <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | this `https://developer.android.com/reference/android/net/VpnService.Builder` object to facilitate chaining method calls. This value cannot be `null`. <br /> |

**See also:**

- `https://developer.android.com/reference/android/net/VpnService.Builder#setUnderlyingNetworks(android.net.Network[])`
- `https://developer.android.com/reference/android/net/ConnectivityManager#isActiveNetworkMetered()`

### setMtu

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder setMtu (int mtu)
```

Set the maximum transmission unit (MTU) of the VPN interface. If
it is not set, the default value in the operating system will be
used.

<br />

| Parameters ||
|---|---|
| `mtu` | `int` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | if the value is not positive. |

### setSession

Added in [API level 14](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder setSession (String session)
```

Set the name of this session. It will be displayed in
system-managed dialogs and notifications. This is recommended
not required.

<br />

| Parameters ||
|---|---|
| `session` | `String`: This value cannot be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | This value cannot be `null`. <br /> |

### setUnderlyingNetworks

Added in [API level 22](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public VpnService.Builder setUnderlyingNetworks (Network[] networks)
```

Sets the underlying networks used by the VPN for its upstream connections.

<br />

| Parameters ||
|---|---|
| `networks` | `Network`: An array of networks the VPN uses to tunnel traffic to/from its servers. This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/net/VpnService.Builder` | this `https://developer.android.com/reference/android/net/VpnService.Builder` object to facilitate chaining method calls. This value cannot be `null`. <br /> |

**See also:**

- `https://developer.android.com/reference/android/net/VpnService#setUnderlyingNetworks(android.net.Network[])`