# CronetProvider


```
public abstract class CronetProvider
```

<br />

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

|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/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/org/chromium/net/impl/JavaCronetProvider` | Implementation of `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider` that creates `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetEngine.Builder` for building the Java-based implementation of `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetEngine`. |

*** ** * ** ***

Provides a factory method to create `https://developer.android.com/develop/connectivity/cronet/reference/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/org/chromium/net/CronetEngine` implementation. To get the list of available `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider`s call `https://developer.android.com/develop/connectivity/cronet/reference/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 |
|---|---|
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#PROVIDER_NAME_APP_PACKAGED() = "App-Packaged-Cronet-Provider"` String returned by `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider` that provides native Cronet implementation packaged inside an application. |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#PROVIDER_NAME_FALLBACK() = "Fallback-Cronet-Provider"` String returned by `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider` that provides Cronet implementation based on the system's `https://developer.android.com/reference/java/net/HttpURLConnection.html` implementation. |
| `static final https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#PROVIDER_NAME_HTTPENGINE_NATIVE() = "HttpEngine-Native-Provider"` String returned by `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider` that provides Cronet implementation based on the HttpEngine implementation present in the Platform. |

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

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

| ### Public methods |
|---|---|
| `abstract https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetEngine.Builder` | `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#createBuilder()()` Creates and returns an instance of `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetEngine.Builder`. |
| `static https://developer.android.com/reference/java/util/List.html<https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider>` | `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#getAllProviders(android.content.Context)(https://developer.android.com/reference/android/content/Context.html context)` Returns an unmodifiable list of all available `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider`s. |
| `abstract https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#getName()()` Returns the provider name. |
| `abstract https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#getVersion()()` Returns the provider version. |
| `abstract boolean` | `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#isEnabled()()` Returns whether the provider is enabled and can be used to instantiate the Cronet engine. |
| `https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#toString()()` |

## Constants

### PROVIDER_NAME_APP_PACKAGED

```
public static final String PROVIDER_NAME_APP_PACKAGED = "App-Packaged-Cronet-Provider"
```

String returned by `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/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/org/chromium/net/CronetProvider#PROVIDER_NAME_FALLBACK()`).

### PROVIDER_NAME_FALLBACK

```
public static final String PROVIDER_NAME_FALLBACK = "Fallback-Cronet-Provider"
```

String returned by `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/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/org/chromium/net/CronetProvider#PROVIDER_NAME_APP_PACKAGED()`).

### PROVIDER_NAME_HTTPENGINE_NATIVE

```
public static final String PROVIDER_NAME_HTTPENGINE_NATIVE = "HttpEngine-Native-Provider"
```

String returned by `https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider#getName()` for `https://developer.android.com/develop/connectivity/cronet/reference/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 fields

### mContext

```
protected final Context mContext
```

## Protected constructors

### CronetProvider

```
protected CronetProvider(Context context)
```

## Public methods

### createBuilder

```
public abstract CronetEngine.Builder createBuilder()
```

Creates and returns an instance of `https://developer.android.com/develop/connectivity/cronet/reference/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/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/org/chromium/net/CronetProvider#isEnabled()`. |

### getAllProviders

```
public static List<CronetProvider> getAllProviders(Context context)
```

Returns an unmodifiable list of all available `https://developer.android.com/develop/connectivity/cronet/reference/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/org/chromium/net/CronetProvider#isEnabled()`.

| Returns |
|---|---|
| `https://developer.android.com/reference/java/util/List.html<https://developer.android.com/develop/connectivity/cronet/reference/org/chromium/net/CronetProvider>` | the list of available providers. |

### getName

```
public abstract String getName()
```

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

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

| Returns |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html` | provider name. |

### getVersion

```
public abstract String getVersion()
```

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

| Returns |
|---|---|
| `https://developer.android.com/reference/java/lang/String.html` | provider version. |

### isEnabled

```
public abstract boolean isEnabled()
```

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 |
|---|---|
| `boolean` | `true` if the provider is enabled. |

### toString

```
public String toString()
```