CMake-opties¶

Geavanceerd¶

gevorderde gebruikers kunnen verder geïnteresseerd zijn in de instellingen van de volgende opties, die in de meeste gevallen automatisch worden afgeleid van de hierboven vermelde Niet-geavanceerde cmake-opties. Om deze opties in de cmake GUI te bekijken, drukt u op de t sleutel inccmake (Unix) of vinkt u het Show Advanced Values vakje aan (Windows).

-DBASIS_ALL_DOC:BOOL

verzoek om de opbouw van alle documentatiedoelen als onderdeel van het ALL targetif BUILD_DOCUMENTATION is ON.

-DBASIS_COMPILE_SCRIPTS:BOOL

compilatie van Python-modules inschakelen. Als deze optie is ingeschakeld, worden alleen de gecompileerde .pyc bestanden geïnstalleerd.

-DBASIS_COMPILE_MATLAB:BOOL

of MATLAB-bronnen gecompileerd moeten worden met behulp van de MATLAB-Compiler (mcc), indien beschikbaar.Indien ingesteld op OFF, worden de MATLAB-bronbestanden gekopieerd als onderdeel van de installatie en wordt het Bash-script voor het uitvoeren van matlab met de optie -c gegenereerd op respectievelijk Unix of een Windows NT-Opdrachtscript op Windows. Dit maakt de convenient uitvoering van het uitvoerbare programma geà mplementeerd in MATLAB zelfs zonder alicense voor de MATLAB Compiler. Elke instantie van de gebouwde uitvoerbare zal nemen upone MATLAB licentie, echter. Bovendien is het opstarten van het uitvoerbare bestand elke keer langer, niet alleen de eerste keer dat het wordt gestart, zoals het geval is voor mcc gecompileerd executables.It daarom wordt aanbevolen om deze optie in te schakelen en indien mogelijk een MATLAB Compilerlicense te verkrijgen. Standaard is deze optie ON.

-DBASIS_DEBUG:BOOL

debugberichten inschakelen tijdens de bouwconfiguratie.

-DBASIS_INSTALL_APIDOC_DIR:PATH

installatiemap van de API-documentatie ten opzichte van het installatievoorvoegsel.

-DBASIS_INSTALL_RPATH:BOOL

of BASIS de juiste INSTALL_RPATH eigenschap van uitvoerbare en gedeelde bibliotheken moet instellen in plaats van CMake. Deze optie is standaard ON en voldoet aan de basisstandaard. Merk op dat deze optie kan worden uitgeschakeld door de projectontwikkelaar of op de opdrachtregel door variableCMAKE_SKIP_RPATH in te stellen op FALSE. Dit wordt typisch gedaan in de config / Settings.cmake.

-DBASIS_INSTALL_SCHEME:STRING

installatie schema, dat wil zeggen, bestandssysteem hiërarchie, te gebruiken voor de installatie van de software bestanden ten opzichte van de installatie prefix gespecificeerd door de -DCMAKE_INSTALL_PREFIX.Geldige waarden zijn default, usr, opt, of win. Zie installatie Treeas gedefinieerd door de bestandssysteem lay-out van BASIS voor meer details.

-DBASIS_INSTALL_SITE_DIR:PATH

installatiemap van de website ten opzichte van het installatievoorvoegsel.

-DBASIS_INSTALL_SITE_PACKAGES:BOOL

of openbare modulebibliotheken die geschreven zijn in een scripttaal zoals asPython of Perl geïnstalleerd moeten worden op de systeembrede standaardlocaties voor sitepakketten. Deze optie is standaard uitgeschakeld omdat schrijfrechten voor deze mappen anders vereist zijn.

-DBASIS_MCC_FLAGS:STRING

extra vlaggen voor MATLAB-Compiler gescheiden door spaties.

-DBASIS_MCC_MATLAB_MODE:BOOL

of de MATLAB-Compiler in MATLAB-modus moet worden aangeroepen. Als ON wordt de MATLAB-Compileraangebeld vanuit een Matlab-interpretersessie, wat resulteert in de onmiddellijke vrijgave van de MATLAB-Compilerlicentie zodra de compilatie is voltooid.Anders wordt de licentie voor een bepaalde tijd gereserveerd (bijv. 30 min).

-DBASIS_MCC_RETRY_ATTEMPTS:INT

aantal keren dat de compilatie van MATLAB Compiler target wordt herhaald in het geval van een licentie checkout fout.

-DBASIS_MCC_RETRY_DELAY:INT

vertraging in aantal seconden tussen pogingen om MATLAB Compiler doelen te bouwen nadat alicense checkout fout is opgetreden.

-DBASIS_MCC_TIMEOUT:INT

time-out in seconden voor het bouwen van een MATLAB Compiler target. Als de compilatie van het doel niet binnen de opgegeven tijd kon worden voltooid, wordt de compilatie onderbroken.

-DBASIS_MEX_FLAGS:STRING

extra vlaggen voor het mex script gescheiden door spaties.

-DBASIS_MEX_TIMEOUT:INT

time-out in seconden voor het bouwen van MEX-bestanden.

-DBASIS_REGISTER:BOOL

of het geïnstalleerde pakket moet worden geregistreerd in het pakketregister van CMake. Deze optie is standaard zo ingeschakeld dat pakketten worden gevonden door CMake wanneer vereist door andere pakketten op basis van deze build tool.

-DBASIS_SUPERBUILD_MODULES:BOOL

experimenteel Schakel de superbuild van project modules. Voor projecten met een groot aantal modules kan dit de configuratietijd van het bouwsysteem drastisch verminderen, omdat de configuratie van elke module wordt uitgesteld tot de bouwstap.De superbuild van modules is standaard uitgeschakeld.Zie Superbuild van Modules voor meer informatie.

-DBASIS_VERBOSE:BOOL

uitgebreide berichten inschakelen tijdens de bouwconfiguratie.

-DBUILD_BASIS_UTILITIES_FOR_<LANG>:BOOL

standaard worden de Basishulpprogramma ’s voor een bepaalde programmeertaal alleen gebouwd als een van de uitvoerbare of bibliotheekdoelen van het project gebouwd vanuit broncode in de betreffende taal gebruik maakt van deze hulpprogramma’ s. Gebruik deze opties om de bouw van de basis Utilities voor de respectieve taal te forceren. Zelfs als ze niet door het project zelf worden gebruikt, kunnen de gegenereerde utility functies en header of scripted modulefiles door een ander project worden gebruikt om toegang te krijgen tot de project meta-data zoals de naam en versie door het opnemen van de respectievelijke project-specifieke basis Utilities.

-DBUILD_CHANGELOG:BOOL

verzoek build van ChangeLog als onderdeel van het ALL doel. Merk op dat de ChangeLogis gegenereerd wordt uit de subversion historie als de broncode boom een SVNworking kopie is, of uit de git historie als het een git repository is. Anders kan het ChangeLog niet worden gegenereerd en wordt deze optie weer uitgeschakeld door BASIS.In in het geval van Subversion, houd er rekening mee dat het aanmaken van het ChangeLog verschillende minuten duurt en mogelijk de invoer van gebruikersreferenties vereist voor toegang tot het Subversion repository. Het wordt aanbevolen om deze optie uitgeschakeld te laten en het changelog doel los te maken van de rest van het softwarepakket (zie Software bouwen).

-DBUILD_MODULES_BY_DEFAULT::BOOL

of projectmodules (d.w.z. subprojecten) standaard worden ingeschakeld of niet. Deze optie heeft alleen effect wanneer deze direct op de opdrachtregel wordt gegeven wanneer cmake ofccmake wordt aangeroepen. Anders wordt de standaardwaarde van deze optie gebruikt voor de eerste build-systeemconfiguratie die de MODULE_* – opties al toevoegt en ze op de respectievelijke standaard (TRUE) zet. Deze standaardwaarde kan niet worden overschreven door opeenvolgende configuraties tenzij de MODULE_*opties zelf worden gewijzigd.

-DITK_DIR:PATH

Geef een antwoord

Het e-mailadres wordt niet gepubliceerd.