Repository navigation
Atlas 2.0.0
English version below.
Atlas 2.0.0 baut auf 1.2.0 auf und ändert vor allem den Aufbau des Plugins.
Die vollständige Liste aller Änderungen steht im Changelog (Abschnitte 2.0.0-beta.1 bis 2.0.0-beta.3). Nach dem Update zeigt die Karte „Neu in Atlas“ auf der Willkommensseite die wichtigsten Neuerungen.
Atlas in Modulen
- Das Plugin besteht jetzt aus dem Kern-Package
Atlas.IDE.Baseund elf Modulen: Debugger, Tests, Build-Werkzeuge, Build-Pipeline, Prüfregeln, Lesezeichen, Suche, Analyse, Designer, Issue-Tracker und Willkommensseite. Man installiert nur, was man braucht (#1454–#1456, ADR 0017). - Jedes Modul hat einen Hauptschalter oben auf seiner Optionsseite und bringt seine Einstellungen selbst mit. Ein ausgeschaltetes Modul stoppt ohne Neustart; ein nicht installiertes fehlt im Optionsdialog, seine Werte bleiben erhalten. Neues Profil „Nur Code Insight“.
- Alles Regelspezifische steckt im Modul Prüfregeln (#1755): Regel-Editor, Baseline, Unterdrückungen und „Regel unterdrücken / einstellen / abschalten“ am Befund. Ohne das Modul zeigt Atlas weiter die Befunde und „Regel erklären“. Baseline und Unterdrückungen stehen jetzt auf der Seite Prüfregeln statt auf Server.
- Die Code Lens mit Code-Metriken gehört zum Modul Analyse (#1756). Die Werte in der Atlas-Statusleiste kommen weiter aus Base.
Installieren und Aktualisieren
- Neu im Paket:
AtlasUpdate.exe(#1519, ADR 0018).AtlasUpdate installrichtet Atlas im Konsolendialog ein: IDE und Profil, Zielordner ohne Adminrechte, Module. - Ab jetzt bietet „Jetzt aktualisieren“ ein neues Release an, lädt und prüft es im Hintergrund (SHA-256, bei signierten Releases auch die Signatur) und spielt es beim Schließen der IDE ein; bei einem Fehler nimmt es alles zurück. Einstellungen
updates.install,updates.channel(auch Vorabversionen) undupdates.newModules. - Delphi 12: Das Paket enthält die BPLs für Delphi 13. Für Delphi 12 baut
AtlasUpdatedas Plugin aus dem Quelltext des Releases; dafür braucht es RAD Studio mit Kommandozeilen-Compiler (MSBuild).
Prüfen
- Wann die offene Datei geprüft wird, ist einstellbar: live mit eigener Verzögerung, beim Speichern oder nur auf Anforderung (
problems.update). „Datei jetzt prüfen“ hat ein eigenes Tastenkürzel, Vorgabe Strg+Umschalt+Alt+P (#1744). - Neue Regel
dfm-reference-unit-missing: Eine Formulardatei verweist auf eine Komponente eines anderen Formulars, dessen Unit nicht in den uses steht. Mit Korrektur „uses ergänzen“. unused-uses(#1135): Das Abblenden im Editor folgt jetzt der Regel (aus, Profil,exclude,lsp-ignore), neue Optionkeep. Einträge, die nur die Formulardatei braucht, gelten nicht mehr als ungenutzt.- Typen aus installierten Packages: Atlas kennt die Typen der in der IDE installierten Packages, auch wenn es nur DCUs gibt.
unresolved-typeundunresolved-identifiermelden sie nicht mehr. - Im Fenster „Atlas-Prüfung“ lässt sich bei einer Projektgruppe auch ein einzelnes Projekt prüfen (#1843).
Editor
- Regionen beim Öffnen auf- oder zuklappen (#1814,
editor.regionFolds), dazu die Befehle „Alle Regionen zuklappen“ und „Alle Regionen aufklappen“. - Lokale Routinen heben sich in Paarfarben und Blocklinien ab (#1788,
highlight.nestedRoutines). - Einrückung beim Tippen (#1827): Nach Enter setzt der Server die Schreibmarke in die passende Spalte (
smartIndent.*). - Klassenvervollständigung (#1834, #1836): Methodenrümpfe stehen gruppiert, der Konstruktor zuerst (
editor.methodPlacement), mit Typkommentar und vorbefüllten Rümpfen (classCompletion.*). - Hover, Vervollständigung und Parameterhilfe kennen auch die Mitglieder der Typen aus installierten Packages. Die published-Mitglieder großer Komponenten scrollen im Hover (#1841).
Sprache und Doku
- Atlas folgt der Sprache der IDE (#1458): Erklärungen der Prüfregeln, Beschreibungen der Einstellungen und die Karte „Neu in Atlas“ gibt es auch auf Englisch. Die Doku ist zweisprachig, mit englischen Seiten unter
docs/en.
Diagnose
- Protokolle, Fehlerbericht und Diagnosepaket sind vollständig anonym (#1478): Namen, Pfade und fremde Texte werden dort gekennzeichnet, wo die Zeile entsteht, und in jeder Ausgabe ersetzt. Klarnamen gibt es nur, wenn man sie ausdrücklich wählt (
diagnostics.log.names).
Behoben
- Projektgruppen brauchen deutlich weniger Speicher: übersetzte Packages (
.dcp) einmal je Prozess, gemeinsamer Cache für Suchpfad-Units, keine doppelte Übernahme von Units. Die Zeit bis „bereit“ sinkt, weil der Server seine eigenen Cache-Sperren nicht mehr über die Datei prüft (#1479). - Weniger abgebrochene Anfragen bei großen Projekten: Der Index gibt über dem Speicherbudget erst Bibliotheksdaten auf, Code-Aktionen nutzen die Befunde der letzten Prüfung, und Inlay-Hints, Glühbirne, Überschreibungen, Gliederung und der Gruß der Willkommensseite blockieren die IDE nicht mehr.
- Atlas-Suche unter Delphi 12: Strg+F schaltete die Suche nach drei Fehlversuchen ab.
- Die Liste „Atlas-Probleme“ im Meldungsfenster erschien bei bestehenden Installationen weiter, obwohl sie seit dem Fenster „Atlas-Prüfung“ Vorgabe aus ist.
- Weniger Fehlalarme, vor allem in den Stilregeln:
hardcoded-string,magic-number,public-field,naming-prefix,method-without-self,handle-leak,owned-field-free-unclearund weitere. - Große Units (über 20.000 Zeilen) prüft der Server mehrfach schneller, und die IDE bleibt dabei flüssig. Bremsen waren Code Lens, Editorleiste, Glühbirne und die Projektdatei-Prüfung.
- Fehlen Module unter „Known Packages“, meldet Atlas das beim Start mit „Wieder eintragen“. Abgewürgte Bau-IDEs führen nicht mehr in den abgesicherten Start.
- Keine Hänger mehr bei der Code Lens „→ Testunit“ und bei den Gerüsten der Schnellbefehle; Zugriffsverletzung beim Entladen eines einzelnen Moduls behoben.
- Ohne
languageinsettings.jsonkamen die Befunde des Servers auf einem deutschen System englisch; die Spracherkennung der IDE ist robuster.
Umstieg von 1.x
- Delphi schließen. Das ZIP entpacken und
AtlasUpdate.exe installausführen. Es entfernt die alten Einträge (Atlas.IDE.Expert…, BetterDelphiLSP, Argus) aus den Known Packages und trägt Kern und Module ein. - Wer von Hand installiert: Den Eintrag
Atlas.IDE.Expert370.bplentfernen, dann zuerstAtlas.IDE.Base370.bplund danach die gewünschten Module (Atlas.IDE.<Modul>370.bpl) hinzufügen. Eine TestfassungAtlas.IDE.Contracts370.bplentfernen; dieses Package gibt es nicht mehr. - Einstellungen, Index, Snippets und Projektdateien bleiben erhalten. Das Protokoll heißt weiter
Atlas.IDE.Expert<Ver>.log.
Atlas 2.0.0 builds on 1.2.0 and mainly changes how the plugin is put together.
The full list of changes is in the changelog (sections 2.0.0-beta.1 to 2.0.0-beta.3, in German). After the update, the “What's new in Atlas” card on the welcome page shows the highlights.
Atlas in modules
- The plugin now consists of the core package
Atlas.IDE.Baseand eleven modules: debugger, tests, build tools, build pipeline, rule checks, bookmarks, search, analysis, designer, issue tracker and welcome page. Install only what you need (#1454–#1456, ADR 0017). - Each module has a main switch at the top of its options page and brings its own settings. A module that is switched off stops without a restart; a module that is not installed is missing from the options dialog, and its values are kept. New profile “Nur Code Insight” (Code Insight only).
- Everything rule-specific lives in the rule checks module (#1755): rule editor, baseline, suppressions and “suppress / configure / disable rule” on a finding. Without the module, Atlas still shows findings and “Explain rule”. Baseline and suppressions are now on the Rules page instead of Server.
- The code lens with code metrics belongs to the analysis module (#1756). The values in the Atlas status bar still come from the core.
Installing and updating
- New in the package:
AtlasUpdate.exe(#1519, ADR 0018).AtlasUpdate installsets up Atlas in a console dialog: IDE and profile, target folder without admin rights, modules. - From now on, “Update now” offers a new release, downloads and verifies it in the background (SHA-256, and the signature for signed releases) and installs it when you close the IDE; on error it rolls everything back. Settings
updates.install,updates.channel(including pre-releases) andupdates.newModules. - Delphi 12: the package contains the BPLs for Delphi 13. For Delphi 12,
AtlasUpdatebuilds the plugin from the release source; this needs RAD Studio with the command-line compiler (MSBuild).
Checks
- When the open file is checked is now configurable: live with its own delay, on save, or only on demand (
problems.update). “Check file now” has its own shortcut, Ctrl+Shift+Alt+P by default (#1744). - New rule
dfm-reference-unit-missing: a form file refers to a component of another form whose unit is not in the uses clause. With the fix “add to uses”. unused-uses(#1135): dimming in the editor now follows the rule (off, profile,exclude,lsp-ignore), new optionkeep. Entries that only the form file needs no longer count as unused.- Types from installed packages: Atlas knows the types of the packages installed in the IDE, even if there are only DCUs.
unresolved-typeandunresolved-identifierno longer report them. - In the “Atlas check” window you can check a single project of a project group (#1843).
Editor
- Fold or unfold regions on opening (#1814,
editor.regionFolds), plus the commands “Collapse all regions” and “Expand all regions”. - Local routines stand out in pair colours and block lines (#1788,
highlight.nestedRoutines). - Indentation while typing (#1827): after Enter, the server puts the cursor in the right column (
smartIndent.*). - Class completion (#1834, #1836): method bodies are grouped with the constructor first (
editor.methodPlacement), with a type comment and pre-filled bodies (classCompletion.*). - Hover, completion and parameter hints also know the members of types from installed packages. The published members of large components scroll in the hover (#1841).
Language and documentation
- Atlas follows the IDE language (#1458): rule explanations, setting descriptions and the “What's new in Atlas” card are also available in English. The documentation is bilingual, with English pages under
docs/en.
Diagnostics
- Logs, bug report and diagnostic package are fully anonymous (#1478): names, paths and foreign text are marked where the line is built and replaced in every output. Plain names only if you choose them explicitly (
diagnostics.log.names).
Fixed
- Project groups need much less memory: compiled packages (
.dcp) once per process, a shared cache for search path units, no duplicate units. The time until “ready” drops because the server no longer probes its own cache locks through the file (#1479). - Fewer aborted requests in large projects: above the memory budget the index gives up library data first, code actions reuse the findings of the last check, and inlay hints, light bulb, overrides, outline and the welcome page greeting no longer block the IDE.
- Atlas search under Delphi 12: Ctrl+F switched the search off after three failed attempts.
- The “Atlas problems” list in the messages window still appeared in existing installations, although it has been off by default since the “Atlas check” window.
- Fewer false positives, mainly in the style rules:
hardcoded-string,magic-number,public-field,naming-prefix,method-without-self,handle-leak,owned-field-free-unclearand others. - The server checks large units (over 20,000 lines) several times faster, and the IDE stays responsive meanwhile. Code lens, editor bar, light bulb and the project file check were slowing it down.
- If modules are missing from the Known Packages, Atlas reports it at startup with “Register again”. Build IDEs that were killed no longer lead to a safe start.
- No more hangs on the “→ Test unit” code lens and the quick-command templates; fixed an access violation when a single module is unloaded.
- Without
languageinsettings.json, server findings came out in English on a German system; detecting the IDE language is more robust.
Upgrading from 1.x
- Close Delphi. Unpack the ZIP and run
AtlasUpdate.exe install. It removes the old entries (Atlas.IDE.Expert…, BetterDelphiLSP, Argus) from the Known Packages and registers the core and the modules. - Installing by hand: remove the entry
Atlas.IDE.Expert370.bpl, then addAtlas.IDE.Base370.bplfirst and the modules you want (Atlas.IDE.<Module>370.bpl) after it. Remove a test build ofAtlas.IDE.Contracts370.bpl; this package no longer exists. - Settings, index, snippets and project files are kept. The log is still called
Atlas.IDE.Expert<Ver>.log.