CMake-Cross-Compilation-Sonden: Kompilieren, Linken und Ausführen unterscheiden

Worum es geht

Cross-Compilation trennt die Maschine, auf der die Build-Werkzeuge laufen, von der Maschine, auf der die Ausgabe später laufen soll. Die Toolchain-Dokumentation von CMake beschreibt Ziel-Suchwurzeln und die Einstellungen von CMAKE_FIND_ROOT_PATH_MODE. Für Toolchains, die während Compiler-Prüfungen kein normales ausführbares Programm linken können, kann CMAKE_TRY_COMPILE_TARGET_TYPE stattdessen eine Prüfung mit einer statischen Bibliothek anfordern. CMake toolchains manual

Warum es wichtig ist

Eine fehlgeschlagene Konfigurationssonde ist nicht automatisch ein Beleg dafür, dass dem Zielsystem ein Merkmal fehlt. Die Sonde hat möglicherweise eine Host-Bibliothek gefunden, eine Zielausführungsumgebung benötigt oder ein Linker-Skript ausgelassen. Agenten sollten die fehlgeschlagene Stufe bestimmen, bevor eine gemessene Fähigkeit durch einen geratenen Cache-Wert ersetzt wird.

So wird es angewendet

• Build-Host, Zielarchitektur, Compiler, Sysroot und beabsichtigte Ausführungsumgebung festhalten. Die Toolchain-Datei zusammen mit den Build-Anweisungen aufbewahren.
• Die genau fehlschlagende Sonde nachlesen und als Kompilier-, Link- oder Ausführungsprüfung einordnen. Ihren Befehl und ihre Diagnose festhalten, ohne Zugangsdaten und nicht zusammenhängende Umgebungsvariablen.
• Bestätigen, dass Bibliotheken und Header aus dem Zielbaum stammen, während Codegeneratoren, die während des Builds laufen müssen, auf dem Host ausführbar sind.
• Kann eine Compiler-Prüfung ohne plattformspezifische Unterstützung nicht linken, eine Sonde mit statischer Bibliothek nur für die Behauptung in Betracht ziehen, dass das Kompilieren ausreicht, um dies zu belegen. Sie nicht als erfolgreichen Test eines ausführbaren Links umdeklarieren.
• Einen Zielsystem-Smoke-Test vorschlagen, der das ursprünglich in Frage gestellte Merkmal durchspielt. Ein autorisiertes Zielsystem oder einen dokumentierten Emulator verwenden und gesondert festhalten, ob die Ausführung möglich war.

Stolpersteine

Dass ein Compiler eine Deklaration akzeptiert, belegt keine Verfügbarkeit zur Laufzeit. Das Vorbelegen einer Cache-Antwort kann angemessen sein, wenn sie aus verlässlichen Belegen zum Zielsystem abgeleitet ist, aber Herkunft und Geltungsbereich festhalten. Ein Wechsel von Sysroot oder Compiler kann alte Antworten ungültig machen. Für eine geänderte Toolchain einen eigenen Build-Baum starten, statt nicht zusammenhängende zwischengespeicherte Sondenergebnisse als übertragbare Tatsachen zu behandeln.