Guide to Integrate Tap2iD Windows SDK

Prerequisites

Ensure your development environment meets the following requirements before proceeding with the integration.

• VS Visual Studio 2022 — When launching for the first time, install the Windows App SDK workload.
• 🔧 Minimum Framework: .NET 8.0
• 🖥 Minimum OS Version: Windows 11
• 📶 Active internet connection: The network must not be restricted by a firewall that could block downloads or installation.

Visual Studio — Workload selection (Windows App SDK)

Recommended Bluetooth Hardware

For reliable Bluetooth connectivity and optimal range, use a compatible USB Bluetooth dongle. The following have been tested and verified by Credence ID:

Add Settings XML to Maven Local Repository

Add the Credence ID Nexus repository to the settings.xml file of your Maven local repository. This enables the SDK packages to be resolved during installation.

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
            https://maven.apache.org/xsd/settings-1.0.0.xsd">

    <profiles>
        <profile>
            <id>nexus</id>
            <repositories>
                <repository>
                    <id>nexus</id>
                    <name>Nexus Repository</name>
                    <url>https://nexus.credenceid.com/repository/credenceid-sdk-group</url>
                </repository>
            </repositories>
        </profile>
    </profiles>

    <activeProfiles>
        <!-- Activate the profile to use the Nexus repository -->
        <activeProfile>nexus</activeProfile>
    </activeProfiles>

</settings>

Configure Nexus Repository in Visual Studio

Open your existing Windows application (or create a new one) in Visual Studio and configure the Credence ID NuGet package source.

1

Open NuGet Package Manager

Right-click on your project in the Solution Explorer and select "Manage NuGet Packages…"

Visual Studio → Right-click project → Manage NuGet Packages

2

Open Package Source Settings

In the NuGet Package Manager, click the Settings (⚙) gear icon in the top-right corner.

NuGet Package Manager — Settings button

3

Add the Credence ID Package Source

Click the "+" button and add the following URL. Keep NuGet.org and Microsoft Visual Studio Offline packages selected too.

NuGet Package Source URL copy

https://nexus.credenceid.com/repository/tap2id-sdk-nuget/

NuGet Options — Add new package source

4

Select "All" as Package Source

In the NuGet Package Manager dropdown, select "All" as the active package source so all sources are searched simultaneously.

NuGet Package Manager — Source dropdown set to "All"

Add the Tap2iD SDK Dependency

With the Credence ID package source configured, search for and install the Tap2iDSdk package.

1

Search and Install

In the NuGet Package Manager Browse tab, search for "Tap2iDSdk" and click "Install".

NuGet Package Manager — Searching "Tap2iDSdk"

2

Apply Changes

Review the list of changes in the preview window and click "Apply" to confirm installation.

Preview Changes — Click Apply

3

Accept License

When prompted with the license agreement dialog, click "I Accept" to proceed.

License Acceptance Dialog

4

Installation Complete

Wait for the installation to finish. The output window will confirm when the package is successfully installed.

Output Window — Installation complete

Installed packages

After installation, verify the following packages appear in your project's references:

Solution Explorer — NuGet references after installation

Next steps