# CronetProvider


```
abstract class CronetProvider
```

<br />

Known direct subclasses [HttpEngineNativeProvider](https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/impl/HttpEngineNativeProvider), [JavaCronetProvider](https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/impl/JavaCronetProvider)

|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/impl/HttpEngineNativeProvider` | A Cronet provider implementation which loads the HttpEngine implementation from the Android platform. |
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/impl/JavaCronetProvider` | Implementation of `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider` that creates `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine.Builder` for building the Java-based implementation of `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine`. |

*** ** * ** ***

Provides a factory method to create `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine.Builder` instances. A `
CronetEngine.Builder` instance can be used to create a specific `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine` implementation. To get the list of available `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider`s call `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getAllProviderInfos(android.content.Context)`.

**NOTE:** This class is for advanced users that want to select a particular Cronet implementation. Most users should simply use `new`CronetEngine.Builder.

## Summary

| ### Constants |
|---|---|
| `const https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#PROVIDER_NAME_APP_PACKAGED() = "App-Packaged-Cronet-Provider"` String returned by `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider` that provides native Cronet implementation packaged inside an application. |
| `const https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#PROVIDER_NAME_FALLBACK() = "Fallback-Cronet-Provider"` String returned by `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider` that provides Cronet implementation based on the system's `https://developer.android.com/reference/java/net/HttpURLConnection.html` implementation. |
| `const https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#PROVIDER_NAME_HTTPENGINE_NATIVE() = "HttpEngine-Native-Provider"` String returned by `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider` that provides Cronet implementation based on the HttpEngine implementation present in the Platform. |

| ### Protected constructors |
|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#CronetProvider(android.content.Context)(context: https://developer.android.com/reference/android/content/Context.html!)` |

| ### Public functions |
|---|---|
| `abstract https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine.Builder!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#createBuilder()()` Creates and returns an instance of `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine.Builder`. |
| `java-static (https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-list/index.html<https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider!>!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getAllProviders(android.content.Context)(context: https://developer.android.com/reference/android/content/Context.html!)` Returns an unmodifiable list of all available `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider`s. |
| `abstract https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getName()()` Returns the provider name. |
| `abstract https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getVersion()()` Returns the provider version. |
| `abstract https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#isEnabled()()` Returns whether the provider is enabled and can be used to instantiate the Cronet engine. |
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#toString()()` |

| ### Protected properties |
|---|---|
| `https://developer.android.com/reference/android/content/Context.html!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#mContext()` |

## Constants

### PROVIDER_NAME_APP_PACKAGED

```
const val PROVIDER_NAME_APP_PACKAGED = "App-Packaged-Cronet-Provider": String!
```

String returned by `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider` that provides native Cronet implementation packaged inside an application. This implementation offers significantly higher performance relative to the fallback Cronet implementations (see `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#PROVIDER_NAME_FALLBACK()`).

### PROVIDER_NAME_FALLBACK

```
const val PROVIDER_NAME_FALLBACK = "Fallback-Cronet-Provider": String!
```

String returned by `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider` that provides Cronet implementation based on the system's `https://developer.android.com/reference/java/net/HttpURLConnection.html` implementation. This implementation offers significantly degraded performance relative to native Cronet implementations (see `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#PROVIDER_NAME_APP_PACKAGED()`).

### PROVIDER_NAME_HTTPENGINE_NATIVE

```
const val PROVIDER_NAME_HTTPENGINE_NATIVE = "HttpEngine-Native-Provider": String!
```

String returned by `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider` that provides Cronet implementation based on the HttpEngine implementation present in the Platform. This implementation doesn't provide functionality which was deemed to be implementation specific, namely access to the netlog and internal metrics. Additionally, support for experimental features is not guaranteed (as with any other Cronet provider).

## Protected constructors

### CronetProvider

```
protected CronetProvider(context: Context!)
```

## Public functions

### createBuilder

```
abstract fun createBuilder(): CronetEngine.Builder!
```

Creates and returns an instance of `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine.Builder`.
**NOTE:** This class is for advanced users that want to select a particular Cronet implementation. Most users should simply use `new`CronetEngine.Builder.

| Returns |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetEngine.Builder!` | `CronetEngine.Builder`. |

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalStateException.html` | if the provider is not enabled (see `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#isEnabled()`. |

### getAllProviders

```
java-static fun getAllProviders(context: Context!): (Mutable)List<CronetProvider!>!
```

Returns an unmodifiable list of all available `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider`s. The providers are returned in no particular order. Some of the returned providers may be in a disabled state and should be enabled by the invoker. See `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#isEnabled()`.

| Returns |
|---|---|
| `(https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-list/index.html<https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider!>!` | the list of available providers. |

### getName

```
abstract fun getName(): String!
```

Returns the provider name. The well-know provider names include:

- `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#PROVIDER_NAME_APP_PACKAGED()`
- `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetProvider#PROVIDER_NAME_FALLBACK()`

| Returns |
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | provider name. |

### getVersion

```
abstract fun getVersion(): String!
```

Returns the provider version. The version can be used to select the newest available provider if multiple providers are available.

| Returns |
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | provider version. |

### isEnabled

```
abstract fun isEnabled(): Boolean
```

Returns whether the provider is enabled and can be used to instantiate the Cronet engine. A provider being out-of-date (older than the API) and needing updating is one potential reason it could be disabled. Please read the provider documentation for enablement procedure.

| Returns |
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `true` if the provider is enabled. |

### toString

```
fun toString(): String!
```

## Protected properties

### mContext

```
protected val mContext: Context!
```