> For the complete documentation index, see [llms.txt](https://docs.wepin.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wepin.io/en/widget-integration/ios-swift-sdk/widget-library/installation.md).

# 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>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wepin.io/en/widget-integration/ios-swift-sdk/widget-library/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.