provider.md

<!-- UTSAPIJSON.getProvider.name -->

<!-- UTSAPIJSON.getProvider.description -->

uni-app的api，统一了多平台的差异。但在app平台，有的功能可以由很多SDK来支撑。比如
- 支付：有支付宝支持、微信支付、iap支付
- 定位：有系统定位、腾讯定位、高德定位

不同的SDK，本身的api是完全不同的，甚至同一个SDK的Android和iOS的API也不一样。

uni-app 通过 provider 机制来统一不同的SDK，屏蔽他们的差异。同一个功能的不同的SDK，都被称为该功能的 provider，即供应商。

比如对于支付模块，有 支付宝 和 微信 这2个 provider 可用。

由于这些[模块和SDK](../collocation/manifest-modules.md)在打包时是可选的，那么在运行时可以通过 `uni.getProvider`，来获取到本App包中包含的provider清单。

注意我们要把SDK和App的概念区分清楚。对于支付的2个provider，支付宝和微信，它们也有各自的主App。

本API `uni.getProvider`，只是获取开发者的App包中的provider清单。但本API不负责判断这些provider的主App是否安装在同一台手机上。

微信比较特殊，如果没有微信App，微信支付无法完成。其他SDK无此限制。

所以微信支付SDK，自身提供了获取微信主App是否安装的API，那么这个API也被封装到了本API返回的对象里。

<!-- UTSAPIJSON.getProvider.compatibility -->

<!-- UTSAPIJSON.getProvider.param -->

<!-- UTSAPIJSON.getProvider.returnValue -->

::: warning uni.getProvider 返回顺序说明：
1. 目前标准基座中注册的 provider 返回顺序如下：
    支付： 微信支付、支付宝；
    定位/地图： 系统定位、腾讯定位

2. 相同 service 下，其他的自注册 provider， 返回顺序在官方 provider 之后；

3. 自注册的 provider 无法保障顺序， 请不要依赖自注册 provider 的顺序；
:::


<!-- UTSAPIJSON.getProvider.tutorial -->

<!-- UTSAPIJSON.getProvider.example -->

## uni.getProviderSync(options) @getProviderSync

<!-- UTSAPIJSON.getProviderSync.description -->

<!-- UTSAPIJSON.getProviderSync.compatibility -->

<!-- UTSAPIJSON.getProviderSync.param -->

<!-- UTSAPIJSON.getProviderSync.returnValue -->

<!-- UTSAPIJSON.getProviderSync.example -->

<!-- UTSAPIJSON.getProviderSync.tutorial -->

## uni.getProviderObjectById(options) @getProviderObjectById

<!-- UTSAPIJSON.getProviderObjectById.description -->

<!-- UTSAPIJSON.getProviderObjectById.compatibility -->

<!-- UTSAPIJSON.getProviderObjectById.param -->

<!-- UTSAPIJSON.getProviderObjectById.returnValue -->

<!-- UTSAPIJSON.getProviderObjectById.example -->

<!-- UTSAPIJSON.getProviderObjectById.tutorial -->

### UniProvider说明

支付Provider：[UniPaymentAlipayProvider](https://doc.dcloud.net.cn/uni-app-x/api/request-payment.html#paymentalipayprovider),[UniPaymentWxpayProvider](https://doc.dcloud.net.cn/uni-app-x/api/request-payment.html#paymentwxpayprovider)

定位Provider：[UniLocationSystemProvider](https://doc.dcloud.net.cn/uni-app-x/api/get-location.html#locationsystemprovider),[UniLocationTencentProvider](https://doc.dcloud.net.cn/uni-app-x/api/get-location.html#locationtencentprovider)

<!-- UTSAPIJSON.getProviderObject.example -->

<!-- UTSAPIJSON.getProviderObject.tutorial -->

<!-- UTSAPIJSON.provider.example -->

## 自定义provider

[自定义支付provider](request-payment.md#customprovider)

[自定义定位provider](get-location.md#customprovider)


### 注意点

- 标准基座android需要在manifest.json中配置才能获取到对应的provider，ios不需要，自定义基座都需要配置。

- 自注册的provider无法保障顺序，请不要依赖自注册provider的顺序。

- provider 获取规则：

  1，如果自定义的service 与 provider 配置与内置的一样，优先采用自定义的。

  2，如果自定义的service下存在多个相同的provider ，编译器会报错。


<!-- UTSAPIJSON.general_type.name -->

<!-- UTSAPIJSON.general_type.param -->