# ApnSetting.Builder
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
# Builder
*** ** * ** ***
Kotlin\|[Java](https://developer.android.com/reference/android/telephony/data/ApnSetting.Builder "View this page in Java")
```
open class Builder
```
|---|----------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) ||
| ↳ | [android.telephony.data.ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) |
Provides a convenient way to set the fields of a[ApnSetting](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting)when creating a new instance. The following settings are required to build an`ApnSetting`:
- apnTypeBitmask
- apnName
- entryName
The example below shows how you might create a new`ApnSetting`:
```kotlin
// Create an MMS proxy address with a hostname. A network might not be
// available, so supply a placeholder (0.0.0.0) IPv4 address to avoid DNS lookup.
String host = "mms.example.com";
byte[] ipAddress = new byte[4];
InetAddress mmsProxy;
try {
mmsProxy = InetAddress.getByAddress(host, ipAddress);
} catch (UnknownHostException e) {
e.printStackTrace();
return;
}
ApnSetting apn = new ApnSetting.Builder()
.setApnTypeBitmask(ApnSetting.TYPE_DEFAULT | ApnSetting.TYPE_MMS)
.setApnName("apn.example.com")
.setEntryName("Example Carrier APN")
.setMmsc(Uri.parse("http://mms.example.com:8002"))
.setMmsProxyAddress(mmsProxy)
.setMmsProxyPort(8799)
.build();
```
## Summary
| Public constructors ||
|----------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#Builder())`()` Default constructor for Builder. |
| Public methods ||
|----------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| open[ApnSetting](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting)! | [build](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#build())`()` Builds[ApnSetting](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting)from this builder. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setAlwaysOn](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setAlwaysOn(kotlin.Boolean))`(`alwaysOn:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` Sets whether the PDU session brought up by this APN should always be on. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setApnName](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setApnName(kotlin.String))`(`apnName:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?`)` Sets the name of the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setApnTypeBitmask](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setApnTypeBitmask(kotlin.Int))`(`apnTypeBitmask:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the bitmask of APN types. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setAuthType](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setAuthType(kotlin.Int))`(`authType:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the authentication type of the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setCarrierEnabled](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setCarrierEnabled(kotlin.Boolean))`(`carrierEnabled:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` Sets the current status for this APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setCarrierId](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setCarrierId(kotlin.Int))`(`carrierId:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the carrier id for this APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setEntryName](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setEntryName(kotlin.String))`(`entryName:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?`)` Sets a human-readable name that describes the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setMmsProxyAddress](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setMmsProxyAddress(kotlin.String))`(`mmsProxy:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?`)` Sets the MMS proxy address of the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#)! | [setMmsProxyAddress](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setMmsProxyAddress(java.net.InetAddress))`(`mmsProxy:` `[InetAddress](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#)!`)` Sets the address of an MMS proxy for the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setMmsProxyPort](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setMmsProxyPort(kotlin.Int))`(`mmsPort:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the MMS proxy port of the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setMmsc](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setMmsc(android.net.Uri))`(`mmsc:` `[Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)?`)` Sets the MMSC Uri of the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setMtuV4](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setMtuV4(kotlin.Int))`(`mtuV4:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Set the default MTU (Maximum Transmission Unit) size in bytes of the IPv4 routes brought up by this APN setting. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setMtuV6](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setMtuV6(kotlin.Int))`(`mtuV6:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Set the default MTU (Maximum Transmission Unit) size in bytes of the IPv6 routes brought up by this APN setting. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setMvnoType](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setMvnoType(kotlin.Int))`(`mvnoType:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the MVNO match type for this APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setNetworkTypeBitmask](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setNetworkTypeBitmask(kotlin.Int))`(`networkTypeBitmask:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets Radio Technology (Network Type) info for this APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setOperatorNumeric](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setOperatorNumeric(kotlin.String))`(`operatorNumeric:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?`)` Sets the numeric operator ID for the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setPassword](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setPassword(kotlin.String))`(`password:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?`)` Sets the APN password of the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setPersistent](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setPersistent(kotlin.Boolean))`(`isPersistent:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` Set if the APN setting should be persistent/non-persistent in modem. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setProfileId](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setProfileId(kotlin.Int))`(`profileId:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the profile id to which the APN saved in modem. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setProtocol](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setProtocol(kotlin.Int))`(`protocol:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the protocol to use to connect to this APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setProxyAddress](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setProxyAddress(kotlin.String))`(`proxy:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?`)` Sets the proxy address of the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#)! | [setProxyAddress](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setProxyAddress(java.net.InetAddress))`(`proxy:` `[InetAddress](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#)!`)` Sets the address of an HTTP proxy for the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setProxyPort](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setProxyPort(kotlin.Int))`(`port:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the proxy port of the APN. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setRoamingProtocol](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setRoamingProtocol(kotlin.Int))`(`roamingProtocol:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Sets the protocol to use to connect to this APN when the device is roaming. |
| open[ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | [setUser](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setUser(kotlin.String))`(`user:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?`)` Sets the APN username of the APN. |
## Public constructors
### Builder
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
Builder()
```
Default constructor for Builder.
## Public methods
### build
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun build(): ApnSetting!
```
Builds[ApnSetting](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting)from this builder.
| Return ||
|-------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [ApnSetting](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting)! | `null`if[setApnName(java.lang.String)](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setApnName(kotlin.String))or[setEntryName(java.lang.String)](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setEntryName(kotlin.String))is empty, or[setApnTypeBitmask(int)](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setApnTypeBitmask(kotlin.Int))doesn't contain a valid bit,[ApnSetting](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting)built from this builder otherwise. |
### setAlwaysOn
Added in[API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setAlwaysOn(alwaysOn: Boolean): ApnSetting.Builder
```
Sets whether the PDU session brought up by this APN should always be on. See 3GPP TS 23.501 section 5.6.13
| Parameters ||
|------------|-----------------------------------------------------------------------------------------------------------------------------|
| `alwaysOn` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html):the always on status to set for this APN |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setApnName
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setApnName(apnName: String?): ApnSetting.Builder
```
Sets the name of the APN.
| Parameters ||
|-----------|----------------------------------------------------------------------------------------------------------------------------------------|
| `apnName` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?:the name to set for the APN This value may be`null`. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setApnTypeBitmask
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setApnTypeBitmask(apnTypeBitmask: Int): ApnSetting.Builder
```
Sets the bitmask of APN types.
Apn types are usage categories for an APN entry. One APN entry may support multiple APN types, eg, a single APN may service regular internet traffic ("default") as well as MMS-specific connections.
The bitmask of APN types is calculated from APN types defined in[ApnSetting](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting).
| Parameters ||
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `apnTypeBitmask` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):a bitmask describing the types of the APN Value is either`0`or a combination of[android.telephony.data.ApnSetting#TYPE_DEFAULT](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_DEFAULT:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_MMS](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_MMS:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_SUPL](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_SUPL:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_DUN](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_DUN:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_HIPRI](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_HIPRI:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_FOTA](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_FOTA:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_IMS](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_IMS:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_CBS](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_CBS:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_IA](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_IA:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_EMERGENCY](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_EMERGENCY:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_MCX](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_MCX:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_XCAP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_XCAP:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_BIP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_BIP:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_VSIM](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_VSIM:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_ENTERPRISE](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_ENTERPRISE:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_RCS](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_RCS:kotlin.Int),[android.telephony.data.ApnSetting#TYPE_OEM_PAID](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_OEM_PAID:kotlin.Int), and[android.telephony.data.ApnSetting#TYPE_OEM_PRIVATE](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#TYPE_OEM_PRIVATE:kotlin.Int) |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setAuthType
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setAuthType(authType: Int): ApnSetting.Builder
```
Sets the authentication type of the APN.
| Parameters ||
|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `authType` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the authentication type to set for the APN Value is android.telephony.data.ApnSetting.AUTH_TYPE_UNKNOWN,[android.telephony.data.ApnSetting#AUTH_TYPE_NONE](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#AUTH_TYPE_NONE:kotlin.Int),[android.telephony.data.ApnSetting#AUTH_TYPE_PAP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#AUTH_TYPE_PAP:kotlin.Int),[android.telephony.data.ApnSetting#AUTH_TYPE_CHAP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#AUTH_TYPE_CHAP:kotlin.Int), or[android.telephony.data.ApnSetting#AUTH_TYPE_PAP_OR_CHAP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#AUTH_TYPE_PAP_OR_CHAP:kotlin.Int) |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setCarrierEnabled
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setCarrierEnabled(carrierEnabled: Boolean): ApnSetting.Builder
```
Sets the current status for this APN.
| Parameters ||
|------------------|---------------------------------------------------------------------------------------------------------------------------|
| `carrierEnabled` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html):the current status to set for this APN |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setCarrierId
Added in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setCarrierId(carrierId: Int): ApnSetting.Builder
```
Sets the carrier id for this APN. See[TelephonyManager.getSimCarrierId()](https://developer.android.com/reference/kotlin/android/telephony/TelephonyManager.html#getSimCarrierId())which provides more background for what a carrier ID is.
| Parameters ||
|-------------|---------------------------------------------------------------------------------------------------------------|
| `carrierId` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the carrier id to set for this APN |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setEntryName
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setEntryName(entryName: String?): ApnSetting.Builder
```
Sets a human-readable name that describes the APN.
| Parameters ||
|-------------|----------------------------------------------------------------------------------------------------------------------------------------------|
| `entryName` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?:the entry name to set for the APN This value may be`null`. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setMmsProxyAddress
Added in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setMmsProxyAddress(mmsProxy: String?): ApnSetting.Builder
```
Sets the MMS proxy address of the APN.
| Parameters ||
|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
| `mmsProxy` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?:the MMS proxy address to set for the APN This value may be`null`. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setMmsProxyAddress
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
Deprecated in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setMmsProxyAddress(mmsProxy: InetAddress!): ApnSetting.Builder!
```
**Deprecated:** *use[setMmsProxyAddress(java.lang.String)](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setMmsProxyAddress(kotlin.String))instead.*
Sets the address of an MMS proxy for the APN. The MMS proxy address can be an IP address or hostname. If`mmsProxy`contains both an IP address and hostname, this method ignores the IP address.
The[java.net.InetAddress](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#)methods[getByName()](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#getByName(kotlin.String))and[getAllByName()](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#getAllByName(kotlin.String))require DNS for hostname resolution. To avoid this requirement when setting a hostname, call[java.net.InetAddress#getByAddress(java.lang.String, byte[])](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#getByAddress(kotlin.String,%20kotlin.ByteArray))with both the hostname and a placeholder IP address. See[above](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#)for an example.
| Parameters ||
|------------|------------------------------------------------------------------------------------------------------------------------------------|
| `mmsProxy` | [InetAddress](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#)!:the MMS proxy address to set for the APN |
### setMmsProxyPort
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setMmsProxyPort(mmsPort: Int): ApnSetting.Builder
```
Sets the MMS proxy port of the APN.
| Parameters ||
|-----------|------------------------------------------------------------------------------------------------------------------|
| `mmsPort` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the MMS proxy port to set for the APN |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setMmsc
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setMmsc(mmsc: Uri?): ApnSetting.Builder
```
Sets the MMSC Uri of the APN.
| Parameters ||
|--------|---------------------------------------------------------------------------------------------------------------------------------------|
| `mmsc` | [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#)?:the MMSC Uri to set for the APN This value may be`null`. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setMtuV4
Added in[API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setMtuV4(mtuV4: Int): ApnSetting.Builder
```
Set the default MTU (Maximum Transmission Unit) size in bytes of the IPv4 routes brought up by this APN setting. Note this value will only be used when MTU size is not provided in`DataCallResponse#getMtuV4()`during network bring up.
| Parameters ||
|---------|----------------------------------------------------------------------------------------------------------------|
| `mtuV4` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the MTU size in bytes of the route. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setMtuV6
Added in[API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setMtuV6(mtuV6: Int): ApnSetting.Builder
```
Set the default MTU (Maximum Transmission Unit) size in bytes of the IPv6 routes brought up by this APN setting. Note this value will only be used when MTU size is not provided in`DataCallResponse#getMtuV6()`during network bring up.
| Parameters ||
|---------|----------------------------------------------------------------------------------------------------------------|
| `mtuV6` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the MTU size in bytes of the route. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setMvnoType
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setMvnoType(mvnoType: Int): ApnSetting.Builder
```
Sets the MVNO match type for this APN.
| Parameters ||
|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `mvnoType` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the MVNO match type to set for this APN Value is android.telephony.data.ApnSetting.MVNO_TYPE_UNKNOWN,[android.telephony.data.ApnSetting#MVNO_TYPE_SPN](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#MVNO_TYPE_SPN:kotlin.Int),[android.telephony.data.ApnSetting#MVNO_TYPE_IMSI](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#MVNO_TYPE_IMSI:kotlin.Int),[android.telephony.data.ApnSetting#MVNO_TYPE_GID](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#MVNO_TYPE_GID:kotlin.Int), or[android.telephony.data.ApnSetting#MVNO_TYPE_ICCID](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#MVNO_TYPE_ICCID:kotlin.Int) |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setNetworkTypeBitmask
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setNetworkTypeBitmask(networkTypeBitmask: Int): ApnSetting.Builder
```
Sets Radio Technology (Network Type) info for this APN.
| Parameters ||
|----------------------|---------------------------------------------------------------------------------------------------------------------|
| `networkTypeBitmask` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the Radio Technology (Network Type) info |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setOperatorNumeric
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setOperatorNumeric(operatorNumeric: String?): ApnSetting.Builder
```
Sets the numeric operator ID for the APN. Numeric operator ID is defined as[android.provider.Telephony.Carriers#MCC](https://developer.android.com/reference/kotlin/android/provider/Telephony.Carriers.html#MCC:kotlin.String)+[android.provider.Telephony.Carriers#MNC](https://developer.android.com/reference/kotlin/android/provider/Telephony.Carriers.html#MNC:kotlin.String).
| Parameters ||
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
| `operatorNumeric` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?:the numeric operator ID to set for this entry This value may be`null`. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setPassword
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setPassword(password: String?): ApnSetting.Builder
```
Sets the APN password of the APN.
| Parameters ||
|------------|------------------------------------------------------------------------------------------------------------------------------------------------|
| `password` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?:the APN password to set for the APN This value may be`null`. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
**See Also**
- [android.provider.Telephony.Carriers#PASSWORD](https://developer.android.com/reference/kotlin/android/provider/Telephony.Carriers.html#PASSWORD:kotlin.String)
### setPersistent
Added in[API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setPersistent(isPersistent: Boolean): ApnSetting.Builder
```
Set if the APN setting should be persistent/non-persistent in modem.
| Parameters ||
|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `isPersistent` | [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html):`true`if this APN setting should be persistent/non-persistent in modem. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | The same instance of the builder. This value cannot be`null`. |
### setProfileId
Added in[API level 33](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setProfileId(profileId: Int): ApnSetting.Builder
```
Sets the profile id to which the APN saved in modem.
| Parameters ||
|-------------|---------------------------------------------------------------------------------------------------------------|
| `profileId` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the profile id to set for the APN. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setProtocol
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setProtocol(protocol: Int): ApnSetting.Builder
```
Sets the protocol to use to connect to this APN.
Protocol is one of the`PDP_type`values in TS 27.007 section 10.1.1.
| Parameters ||
|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `protocol` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the protocol to set to use to connect to this APN Value is[android.telephony.data.ApnSetting#PROTOCOL_IP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_IP:kotlin.Int),[android.telephony.data.ApnSetting#PROTOCOL_IPV6](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_IPV6:kotlin.Int),[android.telephony.data.ApnSetting#PROTOCOL_IPV4V6](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_IPV4V6:kotlin.Int),[android.telephony.data.ApnSetting#PROTOCOL_PPP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_PPP:kotlin.Int),[android.telephony.data.ApnSetting#PROTOCOL_NON_IP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_NON_IP:kotlin.Int), or[android.telephony.data.ApnSetting#PROTOCOL_UNSTRUCTURED](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_UNSTRUCTURED:kotlin.Int) |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setProxyAddress
Added in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setProxyAddress(proxy: String?): ApnSetting.Builder
```
Sets the proxy address of the APN.
| Parameters ||
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------|
| `proxy` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?:the proxy address to set for the APN This value may be`null`. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setProxyAddress
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
Deprecated in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setProxyAddress(proxy: InetAddress!): ApnSetting.Builder!
```
**Deprecated:** *use[setProxyAddress(java.lang.String)](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#setProxyAddress(kotlin.String))instead.*
Sets the address of an HTTP proxy for the APN. The proxy address can be an IP address or hostname. If`proxy`contains both an IP address and hostname, this method ignores the IP address.
The[java.net.InetAddress](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#)methods[getAllByName()](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#getAllByName(kotlin.String))require DNS for hostname resolution. To avoid this requirement when setting a hostname, call[java.net.InetAddress#getByAddress(java.lang.String, byte[])](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#getByAddress(kotlin.String,%20kotlin.ByteArray))with both the hostname and a placeholder IP address. See[above](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#)for an example.
| Parameters ||
|---------|--------------------------------------------------------------------------------------------------------------------------------|
| `proxy` | [InetAddress](https://developer.android.com/reference/kotlin/java/net/InetAddress.html#)!:the proxy address to set for the APN |
### setProxyPort
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setProxyPort(port: Int): ApnSetting.Builder
```
Sets the proxy port of the APN.
| Parameters ||
|--------|--------------------------------------------------------------------------------------------------------------|
| `port` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the proxy port to set for the APN |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setRoamingProtocol
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setRoamingProtocol(roamingProtocol: Int): ApnSetting.Builder
```
Sets the protocol to use to connect to this APN when the device is roaming.
Roaming protocol is one of the`PDP_type`values in TS 27.007 section 10.1.1.
| Parameters ||
|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `roamingProtocol` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the protocol to set to use to connect to this APN when roaming Value is[android.telephony.data.ApnSetting#PROTOCOL_IP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_IP:kotlin.Int),[android.telephony.data.ApnSetting#PROTOCOL_IPV6](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_IPV6:kotlin.Int),[android.telephony.data.ApnSetting#PROTOCOL_IPV4V6](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_IPV4V6:kotlin.Int),[android.telephony.data.ApnSetting#PROTOCOL_PPP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_PPP:kotlin.Int),[android.telephony.data.ApnSetting#PROTOCOL_NON_IP](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_NON_IP:kotlin.Int), or[android.telephony.data.ApnSetting#PROTOCOL_UNSTRUCTURED](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting#PROTOCOL_UNSTRUCTURED:kotlin.Int) |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |
### setUser
Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)
```
open fun setUser(user: String?): ApnSetting.Builder
```
Sets the APN username of the APN.
| Parameters ||
|--------|------------------------------------------------------------------------------------------------------------------------------------------------|
| `user` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?:the APN username to set for the APN This value may be`null`. |
| Return ||
|-----------------------------------------------------------------------------------------------------------------|-----------------------------|
| [ApnSetting.Builder](https://developer.android.com/reference/kotlin/android/telephony/data/ApnSetting.Builder#) | This value cannot be`null`. |