Concepts

Getting Started

Getting Started

Installation & Setup

Requirements

GPAL works in .NET 10 and .NET Framework 4.8 projects. The GPAL NuGet package holds both builds, and your project gets the one that matches its target. That's it for browser automation, since GPAL's default engine (SDi's custom PuppeteerPort implementation) talks to Chrome directly with no separate driver to install. A WebDriver binary is only needed if you choose a Selenium-based engine.

Adding GPAL to Your Project

Install the GPAL NuGet package via the Visual Studio Package Manager or .NET CLI, then add the using directives for the namespaces you need. A workflow that finds elements by image also adds the GPAL.Image package, runs as a 64-bit process, and calls GPALImage.Register() once at startup; see Add-On Packages: Keeping GPAL Light.

using GenerallyPositive;

using GenerallyPositive.Browser;

using GenerallyPositive.Application;

using static GenerallyPositive.Enums;

NOTE

GPAL creates GPAL.yaml with default settings on its first run in a directory, and loads it automatically on every run after that. There is nothing to call manually. Edit the file by hand, or call GPAL.SaveSettings() to persist settings you changed at runtime.

Simple Project Template

A Simple Project Template is included in the GPAL solution. Copy it as a starting point. It includes correct references, a basic Program.cs, and the standard folder layout.

WARNING

GPAL is Windows only, so a .NET 10 project targets net10.0-windows.

On this page

Getting Started
Installation & Setup
  • Requirements
  • Adding GPAL to Your Project
  • Simple Project Template
    • 💬 Ask GPAL