# Початок роботи

[Документація](README.md) · [English](../en/getting-started.md)

Для APEX 26.2 відкрийте [маршрутизатор 26.2](../../skills/apexlang/26.2/SKILL.md), використовуйте його інвентар/приклади та `sqlcl_validate` з абсолютним `sqlcl_bin` (або `SQLCL_BIN`). Локальна компіляторна перевірка потребує Bash і метаданих SQLcl для MMD застосунку, без підключення до БД. Наведені нижче вимоги generation/серверного сценарію стосуються 26.1.

## Вимоги

Для локальної роботи потрібні встановлений pi, Node.js **22.19.0 або новіший** і команда `python3` у `PATH`. Мінімальну версію Node визначено в [package.json](../../package.json); [обгортка локальних перевірок](../../extensions/lib/apexlang-local-validate.mjs) викликає `python3` безпосередньо.

Для серверних команд [включений до пакета skill Oracle](../../skills/apexlang/26.1/apexlang-generation/README.md#requirements) потребує SQLcl **26.1.2 або новішого**, останньої доступної збірки APEX **26.1**, робочого підключення до бази та прав на цільові workspace і схему. Загальні [вимоги Oracle до APEXlang](https://docs.oracle.com/en/database/oracle/sql-developer-command-line/26.1/sqcug/prerequisites-apexlang.html) зазначають SQLcl 26.1 як мінімум. ORDS **26.1.1** додав необхідну підтримку APEXlang; див. [опис випуску ORDS 26.1.1](https://www.oracle.com/tools/ords/ords-relnotes-26.1.1.html). Для гілки SQLcl 26.1.2 Oracle зазначає Java **17 або 21** в [описі випуску](https://www.oracle.com/tools/sqlcl/sqlcl-relnotes-26.1.2.html). Для іншої версії перевіряйте документацію відповідного випуску.

Потрібні **назва збереженого підключення SQLcl** і відповідна **назва APEX workspace**. Розширення приймає назви, а не паролі, облікові дані чи рядки підключення. Локальна робота також потребує наявного застосунку APEXlang або достовірних метаданих схеми, моделі, API чи таблиць.

## Установлення та відкриття проєкту

Установлення для поточного користувача:

```bash
pi install git:github.com/avhrst/pi-apex
```

Для встановлення лише в межах проєкту застосунку виконайте команду в його каталозі:

```bash
pi install git:github.com/avhrst/pi-apex -l
```

Потім запустіть `pi` в каталозі, що містить застосунок і метадані. Це активний робочий каталог: `app_path` має залишатися в його межах.

Щоб спробувати цей репозиторій локально, запустіть `pi -e .` з його checkout. Тоді робочим каталогом буде checkout; команда не обирає зовнішній проєкт застосунку. Кореневий README також містить форму встановлення через npm для використання після публікації пакета. Цей посібник не стверджує, що конкретну версію вже опубліковано.

Pi завантажує skill, коли він доречний. Почніть запит із `/skill:apexlang`, щоб обрати його явно.

## Перша перевірка наявного застосунку

Наведені назви — приклади; підставте реальний шлях застосунку та збережене підключення.

1. Визначте контекст:

   ```text
   /skill:apexlang Досліди цей робочий каталог. Визнач можливі застосунки APEX і наявні достовірні метадані. Поясни, яких вхідних даних бракує.
   ```

2. Перевірте потрібний застосунок локально:

   ```text
   /skill:apexlang Перевір applications/service-ops локально. Виконай аудит compiler-truth, якщо доступні метадані компілятора. Покажи знайдені проблеми та шляхи звітів. Не імпортуй застосунок.
   ```

3. Коли середовище налаштовано, замовте серверну перевірку:

   ```text
   /skill:apexlang Перевір applications/service-ops через збережене підключення apex_dev та APEX workspace SERVICE_OPS_DEV. Спочатку діагностуй середовище, потім виконай серверну перевірку. Не імпортуй застосунок.
   ```

Якщо після успішної серверної перевірки з'явиться діалог наступного кроку, оберіть **Check APEXlang code**, щоб завершити без імпорту. Кожен інтерактивний діалог обмежено п'ятьма хвилинами; скасування, таймаут або відсутність UI не надають дозволу на імпорт.

Точні назви дій наведено в [довіднику інструмента](tool-reference.md), а окремий шлях імпорту — в [архітектурі](architecture.md#порядок-імпорту).

## Створення локального каркаса

Надайте достовірні метадані й alias застосунку, цільовий шлях або підказку щодо назви. `workspace_probe` має визначити контекст, установити `app_context.status=create_new_allowed` і повернути точний `suggested_app_path`. Для `new_app_materialize` потрібні цей шлях, пара назв підключення/workspace та інтерактивне підтвердження.

```text
/skill:apexlang Використай перевірені метадані схеми в цьому робочому каталозі для підготовки нового застосунку APEXlang. Спочатку виконай probe і повідом запропонований шлях. Створи каркас через діалог підтвердження, потім перевір його локально. Не імпортуй застосунок.
```

Матеріалізація створює локальні файли. Створення застосунку на сервері — пізніша операція імпорту з окремим підтвердженням.

## Оновлення повного експорту

У сесії SQLcl із відповідним підключенням замініть заповнювачі перед виконанням:

```text
apex export -applicationid <id> -exptype APEXLANG -split -dir <absolute-parent-directory> -force
```

`-dir` — батьківський каталог; SQLcl створює під ним папку з alias застосунку. `-force` видаляє та створює цю папку заново. Перед оновленням збережіть зміни, наявні лише локально. Настанова розширення передбачає один експорт із заміною, щоб уникнути копій із суфіксами на кшталт `p00005_1.apx`; див. [зареєстровану настанову](../../extensions/apexlang/index.ts).
