# FmxPdfTools - Trial (DCU) Distribution

This folder is the **source-free** trial distribution of the FmxPdfTools component,
shipped as precompiled DCUs. The customer installs the component into Delphi, builds
and runs applications for Windows (Win32) and Android (Android64) targets, and never
sees the source.

## Folder layout

```
Dist\
  D12\                 (Delphi 12 Athens - BDS 23.0)
    Win32\             Win32 DCUs + PDFResources.res
    Android64\         Android64 .dcu + .o + PDFResources.res
    Bpl\               PDFDrawingPackage.bpl + .dcp (Win32 design-time package)
  D13\                 (Delphi 13 Florence - BDS 37.0)
    Win32\  Android64\  Bpl\
  Installer\
    FmxPdfTrialInstaller.exe   <- the tool the customer runs
  README_TRIAL.md
```

> DCUs are specific to the Delphi version AND the platform. D12 DCUs only work with
> Delphi 12, D13 DCUs only with Delphi 13. Targets other than Win32 and Android64
> (Win64, iOS, etc.) are NOT supported in this trial.

## Installation (customer side)

1. **Close** the Delphi IDE (bds.exe).
2. Run `Installer\FmxPdfTrialInstaller.exe`.
3. Select the installed Delphi version(s) and target platform(s) (Windows / Android),
   then click **Install**.
4. Restart Delphi. The components appear on the "FmxPdfTools" palette tab.

The tool does the following (NO compilation):
- Copies `Bpl\PDFDrawingPackage.bpl` + `.dcp` into the version's common folder and
  registers it under **Known Packages** (design-time palette + Design Report menu).
- Adds the matching DCU folder to each selected platform's **Library > Search Path**
  (Win32 -> ...\Win32, Android64 -> ...\Android64).

**Uninstall:** open the same tool and click **Uninstall**. It removes the package
registration, the added Search Path entries, and the copied BPL/DCP.

> Do not delete or move this folder: the DCUs are compiled from here. If you move it,
> run Uninstall + Install again.

## Rebuilding (provider side)

To regenerate all DCUs + BPLs from scratch (next to the source):

```
powershell -ExecutionPolicy Bypass -File build_trial.ps1
# single version:  build_trial.ps1 -Only D13
```

The script builds Release for each version/platform, removes the design-only
`PDFDrawingRegister.dcu` and the Android package link artifacts, and copies
`PDFResources.res` into each platform folder.

> The provider must NOT run `FmxPdfTrialInstaller.exe` on their own DEVELOPMENT
> machine: it writes to the same BPL path as the source-based PDFDrawingPackage
> registration and would alter the development setup. The tool is for customer
> machines only.
