Installation

Complete guide to integrate qPapel Auth library into your Visual Studio C++ project.

This library requires Windows 10/11 (x64) and Visual Studio 2019 or later.

Requirements

Requirement	Version
Operating System	Windows 10/11 (x64)
IDE	Visual Studio 2019 or later
C++ Standard	C++17 or later
Network	Internet connectivity required

Download Library Files

You will receive the following files:

Header File

qPapel.h

• Main library header

• Contains all function declarations

• Place in your Include directory

Library File

Project Setup

1

Create Project Structure

Create the following folder structure in your project:

YourProject/
├── Include/
│   └── qPapel.h
├── Lib/
│   ├── qPapel-ProtectedAuth.lib
│   ├── libsodium.lib
└── Source/
    └── main.cpp

2

Configure Include Directory

Visual Studio GUI

1. Right-click your project in Solution Explorer

2. Select Properties

3. Navigate to Configuration Properties → C/C++ → General

4. Click Additional Include Directories

5. Add your Include folder path:

   $(ProjectDir)Include

   Or absolute path:

   C:\MyProject\Include

6. Click OK

Project File (.vcxproj)

3

Configure Library Directory

Visual Studio GUI

1. In Properties, navigate to Configuration Properties → Linker → General

2. Click Additional Library Directories

3. Add your Lib folder path:

   $(ProjectDir)Lib

   Or absolute path:

   C:\MyProject\Lib

4. Click OK

Project File (.vcxproj)

4

Link the Library

Visual Studio GUI

1. In Properties, navigate to Configuration Properties → Linker → Input

2. Click Additional Dependencies

3. Add:

   qPapel-ProtectedAuth.lib
   libsodium.lib

4. Click OK

Project File (.vcxproj)

Code (Pragma)

5

Set C++ Standard

The library requires C++17 or later.

1. In Properties, navigate to Configuration Properties → C/C++ → Language

2. Set C++ Language Standard to ISO C++17 Standard (/std:c++17) or later

3. Click OK

Verify Installation

Create a test file to verify the setup:

#include <iostream>
#include "qPapel.h"

int main() {
    qPapel::ProtectedAuth auth;
    std::cout << "qPapel Auth library loaded successfully!" << std::endl;
    return 0;
}

Build

Press F7 or click Build → Build Solution

Expected output:

Build succeeded.

Run

If you see the success message, installation is complete!

Troubleshooting

Error: Cannot open include file 'qPapel.h'

Cause: Include directory not configured correctly

Solutions:

1. Verify qPapel.h exists in Include folder

2. Check Include path in project properties

3. Use absolute path if relative path doesn't work

4. Ensure path has no typos

Verify:

// This should work after fixing
#include "qPapel.h"

Error: Unresolved external symbol

Cause: Library not linked properly

Solutions:

1. Verify qPapel-ProtectedAuth.lib exists in Lib folder

2. Check Lib path in project properties

3. Ensure library is added to Additional Dependencies

4. Check platform is x64 (not x86)

Verify in Linker settings:

• Additional Library Directories: Contains Lib path

• Additional Dependencies: Contains qPapel-ProtectedAuth.lib

Error: LNK1104 cannot open file

Cause: Library file not found

Solutions:

1. Check library file exists at specified path

2. Verify filename is exactly qPapel-ProtectedAuth.lib

3. Check for extra spaces in path

4. Use absolute path

Error: C++ standard not supported

Cause: C++ standard is below C++17

Solutions:

1. Open project properties

2. Go to C/C++ → Language

3. Set C++ Language Standard to /std:c++17 or later

4. Rebuild project

Platform mismatch (x86 vs x64)

Cause: Project platform doesn't match library

Solutions:

1. Library is compiled for x64

2. Set your project platform to x64:

   • Build → Configuration Manager

   • Active solution platform → x64

3. Rebuild project

Configuration for Release Build

The same setup works for both Debug and Release configurations.

To configure for Release:

1. Switch to Release configuration

2. Repeat Steps 2-4 above

3. Or select All Configurations in Properties to apply to both

Next Steps

Installation complete! Now configure your API keys.

• Configuration - Get your API keys from dashboard

• Quick Start - Start using the library

• Complete Example - Full application example