Skip to content

Latest commit

 

History

History
118 lines (82 loc) · 4.06 KB

README.md

File metadata and controls

118 lines (82 loc) · 4.06 KB
Raw

Particle Connect iOS

Swift Platforms CocoaPods Compatible License

Summary

Modular Swift wallet adapters and components for EVM & Solana chains. Manage wallet and custom RPC request.

Note

Please note that the SDKs only support ios-arm64 (iOS devices). We currently do not support ios-x86_64-simulator (Intel chip simulators) and ios-arm64-simulator (M-series chip simulators).

Prerequisites

Install the following:

Xcode 15.0 or higher

Xcode version 15.0 or higher
ConnectCommon 2.0.3
ParticleConnect 2.0.3
ParticleAuthAdapter 2.0.3
ConnectWalletConnectAdapter 2.0.3
ConnectEVMConnectAdapter 2.0.3
ConnectPhantomConnectAdapter 2.0.3
ConnectSolanaConnectAdapter 2.0.3

🎯 Support Apple Privacy Manifests

From version 0.2.19, all SDKs have been adapted to Apple's privacy requirements.

The following third-party SDKs require the use of specific versions.

pod 'SwiftyUserDefaults', :git => 'https://github.com/SunZhiC/SwiftyUserDefaults.git', :branch => 'master'
# if you need ConnectWalletConnctAdapter, you should add this line.
pod 'WalletConnectSwiftV2', :git => 'https://github.com/SunZhiC/WalletConnectSwiftV2.git', :branch => 'particle'

Migrating to WalletConnect v2

Starting from version 0.2.0, WalletConnect v2 is supported.

Set the required chains for WalletConnect v2. If not set, the current chain will be used.

ParticleConnect.setWalletConnectV2SupportChainInfos([.ethereum])

🧂 Update Podfile

From 0.1.32, we start to build SDK with XCFramework, that request copy the following text into Podfile.

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
    config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
      end
    end
   end

Make sure that your project meets the following requirements:

Your project must target these platform versions or later:

iOS 14

Getting Started

  • Clone the repo.
  • Replace ParticelNetwork.info with your project info in the Dashboard.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>PROJECT_UUID</key>
	<string>YOUR_PROJECT_UUID</string>
	<key>PROJECT_CLIENT_KEY</key>
	<string>YOUR_PROJECT_CLIENT_KEY</string>
	<key>PROJECT_APP_UUID</key>
	<string>YOUR_PROJECT_APP_UUID</string>
</dict>
</plist>

  • Config your app scheme url, select your app target, in the info section, click add URL Type, past your scheme in URL Schemes. your scheme url should be "pn" + your project app id.

    for example, if you project app id is "63bfa427-cf5f-4742-9ff1-e8f5a1b9826f", you scheme url is "pn63bfa427-cf5f-4742-9ff1-e8f5a1b9826f". image

  • Add Privacy - Camera Usage Description in your info.plist file

Build

pod install --repo-update

Docs

  1. https://developers.particle.network/api-reference/connect/mobile/ios

Give Feedback

Please report bugs or issues to particle-connect-ios/issues

You can also join our Discord.