did-ca-ios - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #go #android #machine-learning #deep-learning #linux #cli #security #pytorch #mcp #openai

did-ca-ios

(★ 187)

did-ca-ios

File Explorer

Download Latest Version (.zip)

- - bug_report.yaml
  - feature_request.yaml
- - auto_assign.yml
  - build.yml
  - cla.yml
- pull_request_template.yml
- .gitkeep
- .gitkeep
- - AppDelegate.swift
  - DIDCA.entitlements
  - GoogleService-Info.plist
  - Info.plist
  - KeyIds.swift
  - SceneDelegate.swift
  - URLs.swift
- - project.pbxproj
- - DIDCATests.swift
- - DIDCAUITests.swift
  - DIDCAUITestsLaunchTests.swift
- - SUIT-Bold.otf
  - SUIT-ExtraBold.otf
  - SUIT-ExtraLight.otf
  - SUIT-Heavy.otf
  - SUIT-Light.otf
  - SUIT-Medium.otf
  - SUIT-Regular.otf
  - SUIT-SemiBold.otf
  - SUIT-Thin.otf
.gitignore
CHANGELOG.md
CLA.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
dependencies-license.md
LICENSE
MAINTAINERS.md
README.md
README_ko.md
RELEASE-PROCESS.md
SECURITY.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DIDCA Guide

![Platform](https://img.shields.io/cocoapods/p/SquishButton.svg?style=flat)
[![Swift](https://img.shields.io/badge/Swift-5-orange.svg?style=flat)](https://developer.apple.com/swift)

## Overview
This document is a guide for using the OpenDID authentication client, and provides users with the ability to create, store, and manage the WalletToken, Lock/Unlock, Key, DID Document, and Verifiable Credential (hereinafter referred to as VC) information required for OpenDID.

## S/W Specifications
| Category         | Details                     |
|------------------|-----------------------------|
| OS               | iOS 15                      |
| Language         | Swift 5.8                   |
| IDE              | Xcode 26.0.1                |
| Build System     | Xcode Basic build system    |
| Compatibility    | iOS 15 or higher            |
| Test Environment | iPhone 15 (17.5) Simulator  |

## Clone and checkout the DIDCA project
```git
git clone https://github.com/OmniOneID/did-ca-ios.git
```

## Build Method
How to compile and test your app using Xcode's default build system.
1. Install Xcode
    - Run Xcode and open the project file (.xcodeproj) by selecting File > Open from the top menu.
2. Open the project
    - When the project is opened, you can check the source files, resource files, and settings files in the Project Navigator on the left side of the Xcode window.
3. Select a simulator or actual device
    - At the top of the Xcode window, there is a menu for selecting the target device to build and run. Here, you can select a simulator such as iPhone or iPad or a connected actual device.
- Simulator: You can select the iOS simulator to run the app on a virtual iPhone or iPad.
- Device: If you have a real device connected, you can select the device.

4. Check the project settings
    - You need to check the project settings before building.
    - Select the project file in the left project tree, and check the Target settings in Project Settings on the right. Here, check iOS Deployment Target (the minimum iOS version supported), Signing & Capabilities (code signing), General (app information and build settings), etc., and modify them if necessary.

## SDK Application Method
Below, we refer to `iOS framework as DIDWalletSDK`. We recommend that you clone and check out the DIDWalletSDK project, then either download the latest version from the release folder or use SPM.
```
git https://github.com/OmniOneID/did-client-sdk-ios
```
- `DIDWalletSDK.framework`

<br>

Please refer to the respective links for their own licenses for third-party libraries used by SDKs.
<br>
[Client SDK License-dependencies](https://github.com/OmniOneID/did-client-sdk-ios/blob/main/dependencies-license.md)
                                
<br>

## How to apply DIDWalletSDK framework to DIDCA project in Xcode

### Using the framework’s own application method.

1. Preparing DIDWalletSDK framework files

- If DIDWalletSDK framework is not present, you need to build from each framework repository to generate .framework file. You can use xcframework by building each simulator and device and using the build_xcframework script for each repository. 
    - xcframework is a framework that supports both simulator and device.

2. Add DIDWalletSDK framework to your project

- Open the DIDCA project in Xcode.
    - Select the DIDCA project in the Project Navigator on the left, then select Target at the top.
    - Scroll down in the General tab to the Frameworks, Libraries, and Embedded Content section.
    - Click the + button at the bottom of this section.
    - In the pop-up that appears, select **Add Other... > Add Files...**, select the DIDWalletSDK frameworks file, and click the Add button.
    - Once the DIDWalletSDK framework is added, you need to enable the Embed & Sign option.
    - If you do not have the above library file, you need to build them from the SDK repository to generate the framework file.
        [Move to Client SDK](https://github.com/OmniOneID/did-client-sdk-ios/tree/main)

3. Modify Build Settings

- Setting the Framework Search Path
        - Click the Build Settings tab in your project, and then find Framework Search Paths in the search box. 
        - If the DIDWalletSDK frameworks are in an external directory, add the path to Framework Search Paths. For example, you can set it as $(PROJECT_DIR)/Frameworks.
    - Set Runpath Search Paths
        - In the search bar, find Runpath Search Paths. If the added framework is not running properly, add the @executable_path/Frameworks value. This sets the path to find the framework when running the app.

4. Add dependencies to SPM

- DIDWalletSDK has a dependency on Swift Collections.
- If the framework is added via SPM, the dependency is included automatically, so this does not apply.
- In the app project’s `Package Dependencies`, click the `+` to add the following items.
```text
https://github.com/apple/swift-collections.git
Exact Version 1.1.4
```
- In the **Choose Package Products** screen, select **OrderedCollections** and set **Add to Target** to your app target.

### Apply Framework via SPM

- In the app project’s `Package Dependencies`, click the `+` to add the following items.
```text
https://github.com/OmniOneID/did-client-sdk-ios.git
```
- Select **Version ≥ 2.0.1** (or choose a version rule such as “Up to Next Major”).
- Add the package to your target.
<br>

### Import and Use

First, modify the URL information for each business in the URLs.swift file.
```swift
struct URLs
{
    public static let TAS_URL       : String = "http://192.168.3.130:18090"
    public static let VERIFIER_URL  : String = "http://192.168.3.130:18092"
    public static let CAS_URL       : String = "http://192.168.3.130:18094"
    public static let WALLET_URL    : String = "http://192.168.3.130:18095"
    public static let API_URL       : String = "http://192.168.3.130:18093"
    public static let DEMO_URL      : String = "http://192.168.3.130:18099"
}
```

And you need to use the DIDWalletSDK module in your project's source files. Import it at the top of the source file that contains the class or method you want to use, like this:
```swift
import DIDWalletSDK
```
The functionality provided by DIDWalletSDK is now available in source code.
```swift
Task { @MainActor in
    do {
        let hWalletToken = try await SDKUtils.createWalletToken(purpose: WalletTokenPurposeEnum.LIST_VC, userId: Properties.getUserId()!)

guard let credentials = try WalletAPI.shared.getAllCredentials(hWalletToken: hWalletToken) else {    
            return
        }
        for credential in self.credentials {
            print("vc: \(try! credential.toJson())")
        }
    } catch let error as WalletSDKError {
        print("error code: \(error.code), message: \(error.message)")
    } catch let error as CommunicationSDKError {
        print("error code: \(error.code), message: \(error.message)")
    } catch let error as WalletCoreError {
        print("error code: \(error.code), message: \(error.message)")
    } catch {
        print("error :\(error)")
    }
}
```

### Build and Test

- Build and Run    
    - Build your project by pressing the Build (Command + B) button at the top of Xcode. If any errors occur during the build, check the error message in the Issue Navigator and resolve the issue.

- Test
    - Once the build is completed successfully, run your app to verify that the framework is working properly. You can use Xcode's debugger and logs to determine if there are any issues.

### Troubleshooting

- If the DIDWalletSDK framework is not loading or working properly, check the following:

- Correct Search Paths: Check if the framework paths are set correctly.
    - Signing & Capabilities: Check if the code signing and certificate settings are set correctly.
    - Dependencies: Check if there are any other libraries that the DIDWalletSDK framework additionally depend on.

## Change Log

ChangeLog can be found : 
<br>
- [CA iOS](CHANGELOG.md)

## OpenDID Demonstration Videos <br>
To watch our demonstration videos of the OpenDID system in action, please visit our [Demo Repository](https://github.com/OmniOneID/did-demo-server). <br>

These videos showcase key features including user registration, VC issuance, and VP submission processes.

## Contributing
Please read [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for details on our code of conduct, and the process for submitting pull requests to us.

## License
[Apache 2.0](LICENSE)