# installation

## Requirements

* iOS 13+
* Swift 5.x
* Xcode 16+

#### Compatibility with WepinLogin 

* `WepinWidget` includes `WepinLogin` as a dependency.
* If you are using a separate version of `WepinLogin` that is **not bundled within this module**, please make sure you are using **WepinLogin v1.1.0 or later**.
* If different Wepin modules use mismatched major versions, it may lead to **compatibility issues**, **unexpected errors**, or **inconsistent behavior**.
* For a stable integration, always use v1.1.0+ across all Wepin modules together.

## Installation

WepinWidget is available through [CocoaPods](https://cocoapods.org/). To install it, simply add the following line to your Podfile:

```sh
pod 'WepinWidget'
```

### Podfile Configuration

Build errors may occur when using Xcode 26.0.1 or later versions. 

> error Unable to find module dependency: 'bcrypt' (in target 'WepinLogin' from project 'Pods') 

If you encounter the above error, please add the following code to your Podfile.

```
post_install do |installer|
  installer.pods_project.targets.each do |target| 
    target.build_configurations.each do |config| 
      config.build_settings['SWIFT_ENABLE_EXPLICIT_MODULES'] = 'NO' 
    end 
  end 
end
```

## Import WepinWidget into your project.

```sh
import WepinWidget
```

## Release

The released package versions can be found on the GitHub repository below.

{% embed url="<https://github.com/WepinWallet/wepin-ios-sdk-widget-v1>" %}