Concepts

Getting Started

Getting Started

Installation & Setup

Adding GPAL to your project takes just a few steps. A NuGet package, the right namespace references, and an optional GPAL.yaml for driver and global settings.

Requirements

GPAL targets .NET Framework 4.8 and requires Visual Studio 2017 or later. You will need the GPAL NuGet package. 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.

using GenerallyPositive;

using GenerallyPositive.Browser;

using GenerallyPositive.Application;

using static GenerallyPositive.Enums;

TIP

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 requires .NET Framework 4.8. Projects targeting .NET Core or .NET 5+ are not currently supported.

On this page

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