Przejdź do treści

Narzędzia i VS Code

Zakres weryfikacji

Treść zachowana z obecnego źródła. Publikacja dokumentacji nie oznacza ponownego potwierdzenia wszystkich komend, przykładów i deklaracji możliwości.

Nad projektem Junexis możesz pracować w VS Code, korzystając z rozszerzenia Junexis Language i narzędzi platformy. Rozszerzenie dodaje obsługę plików .jnx, pokazuje diagnostykę i udostępnia działania dotyczące projektu.

Ten sam projekt, inny edytor

Studio nie jest wymagane do pracy z Junexis. VS Code korzysta z tego samego języka, manifestu projektu i usług platformy. Wybór edytora nie zwiększa zakresu konstrukcji obsługiwanych przez kompilator i nie narzuca jednego modelu architektury.

Co zapewnia rozszerzenie, a co wymaga narzędzi

Obszar Skąd pochodzi działanie
Podświetlanie składni i fragmenty kodu zasoby rozszerzenia
Diagnostyka i funkcje językowe integracja z serwerem językowym LSP oraz CLI kompilatora
Budowanie i lista artefaktów CLI kompilatora i zweryfikowany wynik budowania
Analiza architektoniczna dostępny i skonfigurowany Mentor
Historia wykonania TraceCollector oraz zdarzenia przekazywane przez instrumentację
Uruchamianie i debugowanie narzędzia wybranego środowiska i obsługiwane adaptery

LSP to protokół, przez który edytor komunikuje się z usługą językową. Rozszerzenie łączy obsługę lokalną z usługami zaplecza; nie każda funkcja edytora jest realizowana wyłącznie przez LSP. Samo kolorowanie kodu nie potwierdza, że program jest poprawny lub wykonywalny.

Przykładowy sposób pracy

  1. Otwierasz katalog projektu z junexis.project.toml.
  2. Edytujesz pliki .jnx i przeglądasz komunikaty w panelu problemów.
  3. Wywołujesz Junexis: Zdiagnozuj projekt, aby sprawdzić konfigurację.
  4. Wybierasz Junexis: Sprawdź projekt, a następnie Junexis: Zbuduj projekt.
  5. Przeglądasz artefakty; dla obsługiwanej ścieżki uruchamiasz lub debugujesz wynik.

Przykładowo możesz zmienić regułę alarmu temperatury w magazynie, sprawdzić projekt i porównać wynik działania. Sam udany build nie potwierdza, że próg alarmowy odpowiada rzeczywistym wymaganiom magazynu.

Rola w platformie

flowchart TB
    EDITOR["VS Code"] --> LOCAL["Składnia, snippety i funkcje lokalne"]
    EDITOR --> LSP["LSP"]
    EDITOR --> CLI["CLI kompilatora"]
    EDITOR --> MENTOR["Mentor"]
    EDITOR --> TRACE["TraceCollector"]
    LSP --> DIAG["Diagnostyka i semantyka"]
    CLI --> BUILD["Budowanie, uruchamianie i artefakty"]

Co działa

  • podświetlanie składni i snippety dla .jnx,
  • lokalne funkcje językowe oraz integracja z LSP,
  • diagnostyka, kompilacja i obsługa ostatniego poprawnego buildu,
  • uruchamianie i debugowanie wygenerowanych artefaktów,
  • obsługa map źródeł oraz kontraktów dystrybucji usług zaplecza,
  • integracja Mentora i Narrative,
  • pakowanie rozszerzenia do VSIX,
  • testy kontraktów aktywacji, CLI, LSP, debugowania i dystrybucji.

Wymagania i dostępność

Manifest rozszerzenia wymaga VS Code w wersji co najmniej 1.85. Potrzebny jest zgodny zestaw narzędzi Junexis: CLI dla poleceń projektu, a dla funkcji językowych odpowiednio skonfigurowany serwer LSP lub dostępna ścieżka zastępcza CLI. Mentor, Narrative i narzędzia środowisk docelowych są potrzebne do odpowiadających im działań.

Ścieżki do usług można wskazać w ustawieniach junexis.cliPath, junexis.lspPath i junexis.mentorPath. Wymagania .NET zależą od sposobu dystrybucji usług: uruchamianie pliku .dll i samodzielnej paczki nie jest tym samym przypadkiem.

Możliwość zbudowania pliku VSIX nie oznacza dostępności publicznego wydania. Portal nie udostępnia jeszcze publicznej paczki rozszerzenia ani kompletnego zestawu jego zależności. Instrukcje budowania rozszerzenia ze źródeł pozostają w dokumentacji deweloperskiej.

Narzędzia a Studio

Rozszerzenie VS Code jest lekkim wejściem dla użytkowników istniejącego edytora. Studio składa te same usługi w środowisko poświęcone całemu systemowi, z własnym procesem budowania, uruchamiania, debugowania oraz pracy z Mentorem i Narrative.

Granice

Formatter, parser pomocniczy i pozostałe narzędzia repozytorium mają mniejszą dojrzałość niż rozszerzenie. Brakuje również stabilnego publicznego kanału dystrybucji całego zestawu usług zaplecza.

Obsługa debugowania zależy od środowiska, adaptera oraz dostępnych map źródeł. Nie oznacza uniwersalnego zatrzymywania każdego urządzenia lub pełnego odtwarzania przeszłości systemu. Widoki Narrative wymagają rzeczywistych danych wykonania; opinie Mentora pozostają osobną analizą.

Zobacz Studio, kompilator i CLI.