provider.md 2.8 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
## uni.getProvider(options) @getprovider

<!-- 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 -->

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

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

## uni.getProviderIds(options) @getproviderids

<!-- UTSAPIJSON.getProviderIds.description -->

<!-- UTSAPIJSON.getProviderIds.compatibility -->

<!-- UTSAPIJSON.getProviderIds.param -->

<!-- UTSAPIJSON.getProviderIds.returnValue -->

<!-- UTSAPIJSON.getProviderIds.example -->

<!-- UTSAPIJSON.getProviderIds.tutorial -->

## uni.getProviderObject(options) @getproviderobject

<!-- UTSAPIJSON.getProviderObject.description -->

<!-- UTSAPIJSON.getProviderObject.compatibility -->

<!-- UTSAPIJSON.getProviderObject.param -->

<!-- UTSAPIJSON.getProviderObject.returnValue -->

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

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

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

## 自定义provider

[自定义支付provider](https://doc.dcloud.net.cn/uni-app-x/api/request-payment.html#%E8%87%AA%E5%AE%9A%E4%B9%89%E6%94%AF%E4%BB%98provider)

[自定义定位provider](https://doc.dcloud.net.cn/uni-app-x/api/get-location.html#%E8%87%AA%E5%AE%9A%E4%B9%89%E5%AE%9A%E4%BD%8Dprovider)


### 注意点

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


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

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