| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923 |
- /*
- * Copyright (c) Contributors to the Open 3D Engine Project.
- * For complete copyright and license terms please see the LICENSE at the root of this distribution.
- *
- * SPDX-License-Identifier: Apache-2.0 OR MIT
- *
- */
- #include <source/utils/applicationManager.h>
- #include <AzCore/Asset/AssetManagerBus.h>
- #include <AzCore/Asset/AssetManagerComponent.h>
- #include <AzCore/IO/FileIO.h>
- #include <AzCore/Jobs/Algorithms.h>
- #include <AzCore/Jobs/JobManagerComponent.h>
- #include <AzCore/Module/DynamicModuleHandle.h>
- #include <AzCore/Module/ModuleManagerBus.h>
- #include <AzCore/Slice/SliceSystemComponent.h>
- #include <AzCore/std/string/conversions.h>
- #include <AzCore/StringFunc/StringFunc.h>
- #include <AzCore/UserSettings/UserSettingsComponent.h>
- #include <AzCore/Utils/Utils.h>
- #include <AzFramework/Asset/AssetCatalogComponent.h>
- #include <AzFramework/Entity/GameEntityContextComponent.h>
- #include <AzFramework/FileTag/FileTagComponent.h>
- #include <AzFramework/Input/System/InputSystemComponent.h>
- #include <AzFramework/Platform/PlatformDefaults.h>
- #include <AzFramework/Components/AzFrameworkConfigurationSystemComponent.h>
- #include <AzToolsFramework/Archive/ArchiveComponent.h>
- #include <AzToolsFramework/Asset/AssetDebugInfo.h>
- #include <AzToolsFramework/Asset/AssetUtils.h>
- #include <AzToolsFramework/AssetBundle/AssetBundleComponent.h>
- #include <AzToolsFramework/AssetCatalog/PlatformAddressedAssetCatalogBus.h>
- #include <AzToolsFramework/Prefab/PrefabSystemComponent.h>
- namespace AssetBundler
- {
- const char compareVariablePrefix = '$';
- ApplicationManager::ApplicationManager(int* argc, char*** argv, QObject* parent)
- : QObject(parent)
- , AzToolsFramework::ToolsApplication(argc, argv)
- {
- }
- ApplicationManager::~ApplicationManager()
- {
- DestroyApplication();
- }
- bool ApplicationManager::Init()
- {
- AZ::Debug::TraceMessageBus::Handler::BusConnect();
- ComponentApplication::StartupParameters startupParameters;
- // The AssetBundler does not need to load gems
- startupParameters.m_loadDynamicModules = false;
- Start(AzFramework::Application::Descriptor(), startupParameters);
- AZ::SerializeContext* context;
- AZ::ComponentApplicationBus::BroadcastResult(context, &AZ::ComponentApplicationBus::Events::GetSerializeContext);
- AZ_Assert(context, "No serialize context");
- AzToolsFramework::AssetSeedManager::Reflect(context);
- AzToolsFramework::AssetFileInfoListComparison::Reflect(context);
- AzToolsFramework::AssetBundleSettings::Reflect(context);
- [[maybe_unused]] AZ::IO::FileIOBase* fileIO = AZ::IO::FileIOBase::GetInstance();
- AZ_Assert(fileIO != nullptr, "AZ::IO::FileIOBase must be ready for use.\n");
- m_assetSeedManager = AZStd::make_unique<AzToolsFramework::AssetSeedManager>();
- AZ_TracePrintf(AssetBundler::AppWindowName, "\n");
- // There is no need to update the UserSettings file, so we can avoid a race condition by disabling save on shutdown
- AZ::UserSettingsComponentRequestBus::Broadcast(&AZ::UserSettingsComponentRequests::DisableSaveOnFinalize);
- return true;
- }
- void ApplicationManager::DestroyApplication()
- {
- m_showVerboseOutput = false;
- m_assetSeedManager.reset();
- Stop();
- AZ::Debug::TraceMessageBus::Handler::BusDisconnect();
- }
- bool ApplicationManager::Run()
- {
- const AZ::CommandLine* parser = GetCommandLine();
- bool shouldPrintHelp = ShouldPrintHelp(parser);
- // Check for what command we are running, and if the user wants to see the Help text
- m_commandType = GetCommandType(parser, shouldPrintHelp);
- if (shouldPrintHelp)
- {
- // If someone requested the help text, it doesn't matter if their command is invalid
- OutputHelp(m_commandType);
- return true;
- }
- if (m_commandType == CommandType::Invalid)
- {
- OutputHelp(m_commandType);
- return false;
- }
- if (parser->HasSwitch(ProjectArg))
- {
- if (parser->GetNumSwitchValues(ProjectArg) != 1)
- {
- AZ_Error(AppWindowName, false, "Invalid command : \"--%s\" must have exactly one value.", ProjectArg);
- return false;
- }
- m_currentProjectName = parser->GetSwitchValue(ProjectArg, 0);
- AZ_TracePrintf(AssetBundler::AppWindowName, "Setting project to ( %s ).\n", m_currentProjectName.c_str());
- }
- m_showVerboseOutput = ShouldPrintVerbose(parser);
- m_currentProjectName = AZStd::string_view{ AZ::Utils::GetProjectName() };
- if (m_currentProjectName.empty())
- {
- AZ_Error(AppWindowName, false, "Unable to retrieve project name from the Settings Registry");
- return false;
- }
- // Gems
- if (!AzFramework::GetGemsInfo(m_gemInfoList, *m_settingsRegistry))
- {
- AZ_Error(AppWindowName, false, "Failed to read Gems for project: %s\n", m_currentProjectName.c_str());
- return false;
- }
- m_platformCatalogManager = AZStd::make_unique<AzToolsFramework::PlatformAddressedAssetCatalogManager>();
- InitArgValidationLists();
- switch (m_commandType)
- {
- case CommandType::Seeds:
- return RunSeedsCommands(ParseSeedsCommandData(parser));
- case CommandType::AssetLists:
- return RunAssetListsCommands(ParseAssetListsCommandData(parser));
- case CommandType::ComparisonRules:
- return RunComparisonRulesCommands(ParseComparisonRulesCommandData(parser));
- case CommandType::Compare:
- return RunCompareCommand(ParseCompareCommandData(parser));
- case CommandType::BundleSettings:
- return RunBundleSettingsCommands(ParseBundleSettingsCommandData(parser));
- case CommandType::Bundles:
- return RunBundlesCommands(ParseBundlesCommandData(parser));
- case CommandType::BundleSeed:
- return RunBundleSeedCommands(ParseBundleSeedCommandData(parser));
- }
- return false;
- }
- AZ::ComponentTypeList ApplicationManager::GetRequiredSystemComponents() const
- {
- AZ::ComponentTypeList components = AzFramework::Application::GetRequiredSystemComponents();
- components.emplace_back(azrtti_typeid<AzToolsFramework::AssetBundleComponent>());
- components.emplace_back(azrtti_typeid<AzToolsFramework::ArchiveComponent>());
- components.emplace_back(azrtti_typeid<AzToolsFramework::Prefab::PrefabSystemComponent>());
- for (auto iter = components.begin(); iter != components.end();)
- {
- if (*iter == azrtti_typeid<AzFramework::GameEntityContextComponent>() ||
- *iter == azrtti_typeid<AzFramework::AzFrameworkConfigurationSystemComponent>() ||
- *iter == azrtti_typeid<AzFramework::InputSystemComponent>() ||
- *iter == azrtti_typeid<AZ::SliceSystemComponent>())
- {
- // Asset Bundler does not require the above components to be active
- iter = components.erase(iter);
- }
- else
- {
- ++iter;
- }
- }
- return components;
- }
- void ApplicationManager::SetSettingsRegistrySpecializations(AZ::SettingsRegistryInterface::Specializations& specializations)
- {
- AzToolsFramework::ToolsApplication::SetSettingsRegistrySpecializations(specializations);
- specializations.Append("assetbundler");
- }
- ////////////////////////////////////////////////////////////////////////////////////////////
- // Get Generic Command Info
- ////////////////////////////////////////////////////////////////////////////////////////////
- CommandType ApplicationManager::GetCommandType(const AZ::CommandLine* parser, [[maybe_unused]] bool suppressErrors)
- {
- // Verify that the user has only typed in one sub-command
- size_t numMiscValues = parser->GetNumMiscValues();
- if (numMiscValues == 0)
- {
- AZ_Error(AppWindowName, suppressErrors, "Invalid command: Must provide a sub-command (ex: \"%s\").", AssetBundler::SeedsCommand);
- return CommandType::Invalid;
- }
- else if (numMiscValues > 1)
- {
- AZ_Error(AppWindowName, suppressErrors, "Invalid command: Cannot perform more than one sub-command operation at once");
- return CommandType::Invalid;
- }
- AZStd::string subCommand = parser->GetMiscValue(0);
- if (!azstricmp(subCommand.c_str(),AssetBundler::SeedsCommand))
- {
- return CommandType::Seeds;
- }
- else if (!azstricmp(subCommand.c_str(), AssetBundler::AssetListsCommand))
- {
- return CommandType::AssetLists;
- }
- else if (!azstricmp(subCommand.c_str(), AssetBundler::ComparisonRulesCommand))
- {
- return CommandType::ComparisonRules;
- }
- else if (!azstricmp(subCommand.c_str(), AssetBundler::CompareCommand))
- {
- return CommandType::Compare;
- }
- else if (!azstricmp(subCommand.c_str(), AssetBundler::BundleSettingsCommand))
- {
- return CommandType::BundleSettings;
- }
- else if (!azstricmp(subCommand.c_str(), AssetBundler::BundlesCommand))
- {
- return CommandType::Bundles;
- }
- else if (!azstricmp(subCommand.c_str(), AssetBundler::BundleSeedCommand))
- {
- return CommandType::BundleSeed;
- }
- else
- {
- AZ_Error(AppWindowName, false, "( %s ) is not a valid sub-command", subCommand.c_str());
- return CommandType::Invalid;
- }
- }
- bool ApplicationManager::ShouldPrintHelp(const AZ::CommandLine* parser)
- {
- return parser->HasSwitch(AssetBundler::HelpFlag) || parser->HasSwitch(AssetBundler::HelpFlagAlias);
- }
- bool ApplicationManager::ShouldPrintVerbose(const AZ::CommandLine* parser)
- {
- return parser->HasSwitch(AssetBundler::VerboseFlag);
- }
- void ApplicationManager::InitArgValidationLists()
- {
- m_allSeedsArgs = {
- SeedListFileArg,
- AddSeedArg,
- RemoveSeedArg,
- AddPlatformToAllSeedsFlag,
- RemovePlatformFromAllSeedsFlag,
- UpdateSeedPathArg,
- RemoveSeedPathArg,
- PrintFlag,
- PlatformArg,
- AssetCatalogFileArg,
- VerboseFlag,
- ProjectArg,
- IgnoreFileCaseFlag
- };
- m_allAssetListsArgs = {
- AssetListFileArg,
- SeedListFileArg,
- AddSeedArg,
- AddDefaultSeedListFilesFlag,
- PlatformArg,
- AssetCatalogFileArg,
- PrintFlag,
- DryRunFlag,
- GenerateDebugFileFlag,
- AllowOverwritesFlag,
- VerboseFlag,
- SkipArg,
- ProjectArg
- };
- m_allComparisonRulesArgs = {
- ComparisonRulesFileArg,
- ComparisonTypeArg,
- ComparisonFilePatternArg,
- ComparisonFilePatternTypeArg,
- ComparisonTokenNameArg,
- ComparisonFirstInputArg,
- ComparisonSecondInputArg,
- AddComparisonStepArg,
- RemoveComparisonStepArg,
- MoveComparisonStepArg,
- EditComparisonStepArg,
- PrintFlag,
- VerboseFlag,
- ProjectArg
- };
- m_allCompareArgs =
- {
- ComparisonRulesFileArg,
- ComparisonTypeArg,
- ComparisonFilePatternArg,
- ComparisonFilePatternTypeArg,
- CompareFirstFileArg,
- CompareSecondFileArg,
- CompareOutputFileArg,
- ComparePrintArg,
- IntersectionCountArg,
- AllowOverwritesFlag,
- PlatformArg,
- VerboseFlag,
- ProjectArg
- };
- m_allBundleSettingsArgs = {
- BundleSettingsFileArg,
- AssetListFileArg,
- OutputBundlePathArg,
- BundleVersionArg,
- MaxBundleSizeArg,
- PlatformArg,
- PrintFlag,
- VerboseFlag,
- ProjectArg
- };
- m_allBundlesArgs = {
- BundleSettingsFileArg,
- AssetListFileArg,
- OutputBundlePathArg,
- BundleVersionArg,
- MaxBundleSizeArg,
- PlatformArg,
- AllowOverwritesFlag,
- VerboseFlag,
- ProjectArg
- };
- m_allBundleSeedArgs = {
- BundleSettingsFileArg,
- AddSeedArg,
- OutputBundlePathArg,
- BundleVersionArg,
- MaxBundleSizeArg,
- PlatformArg,
- AssetCatalogFileArg,
- AllowOverwritesFlag,
- VerboseFlag,
- ProjectArg
- };
- }
- ////////////////////////////////////////////////////////////////////////////////////////////
- // Store Detailed Command Info
- ////////////////////////////////////////////////////////////////////////////////////////////
- AZ::Outcome<SeedsParams, AZStd::string> ApplicationManager::ParseSeedsCommandData(const AZ::CommandLine* parser)
- {
- using namespace AzToolsFramework;
- auto validateArgsOutcome = ValidateInputArgs(parser, m_allSeedsArgs);
- if (!validateArgsOutcome.IsSuccess())
- {
- OutputHelpSeeds();
- return AZ::Failure(validateArgsOutcome.TakeError());
- }
- SeedsParams params;
- params.m_ignoreFileCase = parser->HasSwitch(IgnoreFileCaseFlag);
- // Read in Seed List Files arg
- auto requiredArgOutcome = GetFilePathArg(parser, SeedListFileArg, SeedsCommand, true);
- if (!requiredArgOutcome.IsSuccess())
- {
- return AZ::Failure(requiredArgOutcome.GetError());
- }
- bool checkFileCase = true;
- // Seed List files do not have platform-specific file names
- params.m_seedListFile = FilePath(requiredArgOutcome.GetValue(), checkFileCase, params.m_ignoreFileCase);
- if (!params.m_seedListFile.IsValid())
- {
- return AZ::Failure(params.m_seedListFile.ErrorString());
- }
- // Read in Add/Remove Platform to All Seeds flag
- params.m_addPlatformToAllSeeds = parser->HasSwitch(AddPlatformToAllSeedsFlag);
- params.m_removePlatformFromAllSeeds = parser->HasSwitch(RemovePlatformFromAllSeedsFlag);
- if (params.m_addPlatformToAllSeeds && params.m_removePlatformFromAllSeeds)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: Unable to run \"--%s\" and \"--%s\" at the same time.", AssetBundler::AddPlatformToAllSeedsFlag, AssetBundler::RemovePlatformFromAllSeedsFlag));
- }
- if ((params.m_addPlatformToAllSeeds || params.m_removePlatformFromAllSeeds) && !parser->HasSwitch(PlatformArg))
- {
- return AZ::Failure(AZStd::string::format("Invalid command: When running \"--%s\" or \"--%s\", the \"--%s\" arg is required.", AddPlatformToAllSeedsFlag, RemovePlatformFromAllSeedsFlag, PlatformArg));
- }
- // Read in Platform arg
- auto platformOutcome = GetPlatformArg(parser);
- if (!platformOutcome.IsSuccess())
- {
- return AZ::Failure(platformOutcome.GetError());
- }
- params.m_platformFlags = GetInputPlatformFlagsOrEnabledPlatformFlags(platformOutcome.GetValue());
- // Read in Asset Catalog File arg
- auto argOutcome = GetFilePathArg(parser, AssetCatalogFileArg, SeedsCommand);
- if (!argOutcome.IsSuccess())
- {
- return AZ::Failure(argOutcome.GetError());
- }
- if (!argOutcome.IsSuccess())
- {
- params.m_assetCatalogFile = FilePath(argOutcome.GetValue(), checkFileCase, params.m_ignoreFileCase);
- if (!params.m_assetCatalogFile.IsValid())
- {
- return AZ::Failure(params.m_assetCatalogFile.ErrorString());
- }
- }
- // Read in Add Seed arg
- params.m_addSeedList = GetAddSeedArgList(parser);
- // Read in Remove Seed arg
- size_t numRemoveSeedArgs = 0;
- if (parser->HasSwitch(RemoveSeedArg))
- {
- numRemoveSeedArgs = parser->GetNumSwitchValues(RemoveSeedArg);
- for (size_t removeSeedIndex = 0; removeSeedIndex < numRemoveSeedArgs; ++removeSeedIndex)
- {
- params.m_removeSeedList.push_back(parser->GetSwitchValue(RemoveSeedArg, removeSeedIndex));
- }
- }
- // Read Update Seed Path arg
- params.m_updateSeedPathHint = parser->HasSwitch(UpdateSeedPathArg);
- // Read Update Seed Path arg
- params.m_removeSeedPathHint = parser->HasSwitch(RemoveSeedPathArg);
- // Read in Print flag
- params.m_print = parser->HasSwitch(PrintFlag);
- return AZ::Success(params);
- }
- AZStd::string ApplicationManager::GetBinaryArgOptionFailure(const char* arg1, const char* arg2)
- {
- const char FailureMessage[] = "Missing argument: Either %s or %s must be supplied";
- return AZStd::string::format(FailureMessage, arg1, arg2);
- }
- AZ::Outcome<AssetListsParams, AZStd::string> ApplicationManager::ParseAssetListsCommandData(const AZ::CommandLine* parser)
- {
- auto validateArgsOutcome = ValidateInputArgs(parser, m_allAssetListsArgs);
- if (!validateArgsOutcome.IsSuccess())
- {
- OutputHelpAssetLists();
- return AZ::Failure(validateArgsOutcome.TakeError());
- }
- AssetListsParams params;
- // Read in Platform arg
- auto platformOutcome = GetPlatformArg(parser);
- if (!platformOutcome.IsSuccess())
- {
- return AZ::Failure(platformOutcome.GetError());
- }
- params.m_platformFlags = GetInputPlatformFlagsOrEnabledPlatformFlags(platformOutcome.GetValue());
- // Read in Print flag
- params.m_print = parser->HasSwitch(PrintFlag);
- // Read in Asset List File arg
- auto requiredArgOutcome = GetFilePathArg(parser, AssetListFileArg, AssetListsCommand, false);
- params.m_assetListFile = FilePath(requiredArgOutcome.GetValue());
-
- if (!params.m_print && !params.m_assetListFile.IsValid())
- {
- return AZ::Failure(GetBinaryArgOptionFailure(PrintFlag,AssetListFileArg));
- }
- // Read in Seed List File arg
- size_t numSeedListFiles = parser->GetNumSwitchValues(SeedListFileArg);
- for (size_t seedListFileIndex = 0; seedListFileIndex < numSeedListFiles; ++seedListFileIndex)
- {
- params.m_seedListFiles.emplace_back(FilePath(parser->GetSwitchValue(SeedListFileArg, seedListFileIndex)));
- }
- // Read in Add Seed arg
- params.m_addSeedList = GetAddSeedArgList(parser);
- // Read in Skip arg
- params.m_skipList = GetSkipArgList(parser);
- // Read in Add Default Seed List Files arg
- params.m_addDefaultSeedListFiles = parser->HasSwitch(AddDefaultSeedListFilesFlag);
- // Read in Asset Catalog File arg
- auto argOutcome = GetFilePathArg(parser, AssetCatalogFileArg, AssetListsCommand);
- if (!argOutcome.IsSuccess())
- {
- return AZ::Failure(argOutcome.GetError());
- }
- if (!argOutcome.IsSuccess())
- {
- params.m_assetCatalogFile = FilePath(argOutcome.GetValue());
- }
- // Read in Dry Run flag
- params.m_dryRun = parser->HasSwitch(DryRunFlag);
- // Read in Generate Debug File flag
- params.m_generateDebugFile = parser->HasSwitch(GenerateDebugFileFlag);
- // Read in Allow Overwrites flag
- params.m_allowOverwrites = parser->HasSwitch(AllowOverwritesFlag);
- return AZ::Success(params);
- }
- AZ::Outcome<ComparisonRulesParams, AZStd::string> ApplicationManager::ParseComparisonRulesCommandData(const AZ::CommandLine* parser)
- {
- auto validateArgsOutcome = ValidateInputArgs(parser, m_allComparisonRulesArgs);
- if (!validateArgsOutcome.IsSuccess())
- {
- OutputHelpComparisonRules();
- return AZ::Failure(validateArgsOutcome.TakeError());
- }
- ScopedTraceHandler traceHandler;
- ComparisonRulesParams params;
- auto requiredArgOutcome = GetFilePathArg(parser, ComparisonRulesFileArg, ComparisonRulesCommand, true);
- if (!requiredArgOutcome.IsSuccess())
- {
- return AZ::Failure(requiredArgOutcome.GetError());
- }
- params.m_comparisonRulesFile = FilePath(requiredArgOutcome.GetValue());
- if (params.m_comparisonRulesFile.AbsolutePath().empty())
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" cannot be empty.", ComparisonRulesFileArg));
- }
- // Read in Add Comparison Step arg
- if (parser->HasSwitch(AddComparisonStepArg))
- {
- size_t numInputs = parser->GetNumSwitchValues(AddComparisonStepArg);
- switch (numInputs)
- {
- case 0:
- params.m_comparisonRulesStepAction = ComparisonRulesStepAction::AddToEnd;
- break;
- case 1:
- params.m_comparisonRulesStepAction = ComparisonRulesStepAction::Add;
- params.m_destinationLine = static_cast<size_t>(AZ::StringFunc::ToInt(parser->GetSwitchValue(AddComparisonStepArg, 0).c_str()));
- break;
- default:
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" cannot have more than one input value.", AddComparisonStepArg));
- }
- // Read in what the user wants to add
- auto parseComparisonTypesOutcome = ParseComparisonTypesAndPatterns(parser, params);
- if (!parseComparisonTypesOutcome.IsSuccess())
- {
- return AZ::Failure(parseComparisonTypesOutcome.GetError());
- }
- }
- // Read in Remove Comparison Step arg
- if (parser->HasSwitch(RemoveComparisonStepArg))
- {
- if (params.m_comparisonRulesStepAction != ComparisonRulesStepAction::Default)
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: Only one of the following args may be used in a single command: \"--%s\", \"--%s\", \"--%s\", \"--%s\".",
- AddComparisonStepArg, RemoveComparisonStepArg, MoveComparisonStepArg, EditComparisonStepArg));
- }
- if (parser->GetNumSwitchValues(RemoveComparisonStepArg) != 1)
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: \"--%s\" requires exatly one input value (the line number you wish to remove).",
- RemoveComparisonStepArg));
- }
- params.m_comparisonRulesStepAction = ComparisonRulesStepAction::Remove;
- params.m_initialLine = static_cast<size_t>(AZ::StringFunc::ToInt(parser->GetSwitchValue(RemoveComparisonStepArg, 0).c_str()));
- }
- // Read in Move Comparison Step arg
- if (parser->HasSwitch(MoveComparisonStepArg))
- {
- if (params.m_comparisonRulesStepAction != ComparisonRulesStepAction::Default)
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: Only one of the following args may be used in a single command: \"--%s\", \"--%s\", \"--%s\", \"--%s\".",
- AddComparisonStepArg, RemoveComparisonStepArg, MoveComparisonStepArg, EditComparisonStepArg));
- }
- if (parser->GetNumSwitchValues(MoveComparisonStepArg) != 2)
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: \"--%s\" requires exatly two input values (the line number of the Comparison Step you wish to move, and the destination line)",
- MoveComparisonStepArg));
- }
- params.m_comparisonRulesStepAction = ComparisonRulesStepAction::Move;
- params.m_initialLine = static_cast<size_t>(AZ::StringFunc::ToInt(parser->GetSwitchValue(MoveComparisonStepArg, 0).c_str()));
- params.m_destinationLine = static_cast<size_t>(AZ::StringFunc::ToInt(parser->GetSwitchValue(MoveComparisonStepArg, 1).c_str()));
- }
- // Read in Edit Comparison Step arg
- if (parser->HasSwitch(EditComparisonStepArg))
- {
- if (params.m_comparisonRulesStepAction != ComparisonRulesStepAction::Default)
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: Only one of the following args may be used in a single command: \"--%s\", \"--%s\", \"--%s\", \"--%s\".",
- AddComparisonStepArg, RemoveComparisonStepArg, MoveComparisonStepArg, EditComparisonStepArg));
- }
- if (parser->GetNumSwitchValues(EditComparisonStepArg) != 1)
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: \"--%s\" requires exactly one input value (the line number of the Comparison Step you wish to edit)",
- EditComparisonStepArg));
- }
- params.m_comparisonRulesStepAction = ComparisonRulesStepAction::Edit;
- params.m_initialLine = static_cast<size_t>(AZ::StringFunc::ToInt(parser->GetSwitchValue(EditComparisonStepArg, 0).c_str()));
- // When editing a Comparison Step, we can only accept one input for every value type
- auto parseComparisonTypesForEditOutcome = ParseComparisonTypesAndPatternsForEditCommand(parser, params);
- if (!parseComparisonTypesForEditOutcome.IsSuccess())
- {
- return AZ::Failure(parseComparisonTypesForEditOutcome.GetError());
- }
- }
- auto parseFirstAndSecondInputsOutcome = ParseComparisonRulesFirstAndSecondInputArgs(parser, params);
- if (!parseFirstAndSecondInputsOutcome.IsSuccess())
- {
- return AZ::Failure(parseFirstAndSecondInputsOutcome.GetError());
- }
- if (parser->HasSwitch(ComparisonTypeArg) &&
- !parser->HasSwitch(AddComparisonStepArg) &&
- !parser->HasSwitch(EditComparisonStepArg))
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: \"--%s\" cannot be used without one of the following operations: \"--%s\", \"--%s\".",
- ComparisonTypeArg, AddComparisonStepArg, EditComparisonStepArg));
- }
- for (const auto& comparisonType : params.m_comparisonTypeList)
- {
- if (comparisonType == AzToolsFramework::AssetFileInfoListComparison::ComparisonType::IntersectionCount)
- {
- return AZ::Failure(AZStd::string::format("Adding compare operation ( %s ) to comparison rule file is not supported currently.", AzToolsFramework::AssetFileInfoListComparison::ComparisonTypeNames[aznumeric_cast<AZ::u8>(AzToolsFramework::AssetFileInfoListComparison::ComparisonType::IntersectionCount)]));
- }
- }
- // Read in Print flag
- params.m_print = parser->HasSwitch(PrintFlag);
- return AZ::Success(params);
- }
- AZ::Outcome<void, AZStd::string> ApplicationManager::ParseComparisonTypesAndPatterns(const AZ::CommandLine* parser, ComparisonRulesParams& params)
- {
- int filePatternsConsumed = 0;
- size_t numComparisonTypes = parser->GetNumSwitchValues(ComparisonTypeArg);
- size_t numFilePatterns = parser->GetNumSwitchValues(ComparisonFilePatternArg);
- size_t numPatternTypes = parser->GetNumSwitchValues(ComparisonFilePatternTypeArg);
- size_t numIntersectionCount = parser->GetNumSwitchValues(IntersectionCountArg);
- if (numIntersectionCount > 1)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" must have exactly one value.", IntersectionCountArg));
- }
- params.m_intersectionCount = AZStd::stoi(parser->GetSwitchValue(IntersectionCountArg, 0));
- size_t numTokenNames = parser->GetNumSwitchValues(ComparisonTokenNameArg);
- if (numTokenNames > 0 && numComparisonTypes != numTokenNames)
- {
- return AZ::Failure(AZStd::string::format(
- "Number of comparisonTypes ( %zu ) and tokenNames ( %zu ) must match. Token values can always be edited later using the \"--%s\" and \"--%s\" args.",
- numComparisonTypes, numTokenNames, EditComparisonStepArg, ComparisonTokenNameArg));
- }
- if (numPatternTypes != numFilePatterns)
- {
- return AZ::Failure(AZStd::string::format("Number of filePatternTypes ( %zu ) and filePatterns ( %zu ) must match.", numPatternTypes, numFilePatterns));
- }
- for (size_t comparisonTypeIndex = 0; comparisonTypeIndex < numComparisonTypes; ++comparisonTypeIndex)
- {
- auto comparisonTypeOutcome = ParseComparisonType(parser->GetSwitchValue(ComparisonTypeArg, comparisonTypeIndex));
- if (!comparisonTypeOutcome.IsSuccess())
- {
- return AZ::Failure(comparisonTypeOutcome.GetError());
- }
- auto comparisonType = comparisonTypeOutcome.GetValue();
- if (comparisonType == AzToolsFramework::AssetFileInfoListComparison::ComparisonType::FilePattern)
- {
- if (filePatternsConsumed >= numFilePatterns)
- {
- return AZ::Failure(AZStd::string::format("Number of file patterns comparisons exceeded number of file patterns provided ( %zu ).", numFilePatterns));
- }
- params.m_filePatternList.emplace_back(parser->GetSwitchValue(ComparisonFilePatternArg, filePatternsConsumed));
- auto filePatternTypeOutcome = ParseFilePatternType(parser->GetSwitchValue(ComparisonFilePatternTypeArg, filePatternsConsumed));
- if (!filePatternTypeOutcome.IsSuccess())
- {
- return AZ::Failure(filePatternTypeOutcome.GetError());
- }
- params.m_filePatternTypeList.emplace_back(filePatternTypeOutcome.GetValue());
- filePatternsConsumed++;
- }
- else
- {
- params.m_filePatternList.emplace_back("");
- params.m_filePatternTypeList.emplace_back(AzToolsFramework::AssetFileInfoListComparison::FilePatternType::Default);
- }
- if (numTokenNames > 0)
- {
- AZStd::string tokenName = parser->GetSwitchValue(ComparisonTokenNameArg, comparisonTypeIndex);
- AzToolsFramework::AssetFileInfoListComparison::FormatOutputToken(tokenName);
- params.m_tokenNamesList.emplace_back(tokenName);
- }
- else
- {
- params.m_tokenNamesList.emplace_back("");
- }
- params.m_comparisonTypeList.emplace_back(comparisonType);
- }
- if (filePatternsConsumed != numFilePatterns)
- {
- return AZ::Failure(AZStd::string::format("Number of provided file patterns exceeded the number of file pattern comparisons ( %zu ).", numFilePatterns));
- }
- return AZ::Success();
- }
- AZ::Outcome<void, AZStd::string> ApplicationManager::ParseComparisonTypesAndPatternsForEditCommand(const AZ::CommandLine* parser, ComparisonRulesParams& params)
- {
- if (parser->HasSwitch(ComparisonTypeArg))
- {
- size_t numComparisonTypes = parser->GetNumSwitchValues(ComparisonTypeArg);
- if (numComparisonTypes > 1)
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: when using the \"--%s\" arg, the \"--%s\" arg can accept no more than one input value.",
- EditComparisonStepArg, ComparisonTypeArg));
- }
- auto comparisonTypeOutcome = ParseComparisonType(parser->GetSwitchValue(ComparisonTypeArg, 0));
- if (!comparisonTypeOutcome.IsSuccess())
- {
- return AZ::Failure(comparisonTypeOutcome.GetError());
- }
- params.m_comparisonTypeList.emplace_back(comparisonTypeOutcome.GetValue());
- }
- if (parser->HasSwitch(ComparisonFilePatternTypeArg))
- {
- size_t numPatternTypes = parser->GetNumSwitchValues(ComparisonFilePatternTypeArg);
- if (numPatternTypes > 1)
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: when using the \"--%s\" arg, the \"--%s\" arg can accept no more than one input value.",
- EditComparisonStepArg, ComparisonFilePatternTypeArg));
- }
- auto filePatternTypeOutcome = ParseFilePatternType(parser->GetSwitchValue(ComparisonFilePatternTypeArg, 0));
- if (!filePatternTypeOutcome.IsSuccess())
- {
- return AZ::Failure(filePatternTypeOutcome.GetError());
- }
- params.m_filePatternTypeList.emplace_back(filePatternTypeOutcome.GetValue());
- }
- if (parser->HasSwitch(ComparisonFilePatternArg))
- {
- size_t numFilePatterns = parser->GetNumSwitchValues(ComparisonFilePatternArg);
- switch (numFilePatterns)
- {
- case 0:
- // Our CLI parser will not return empty strings, so we need an extra case to check if a user wants to remove a FilePattern
- params.m_filePatternList.emplace_back("");
- break;
- case 1:
- params.m_filePatternList.emplace_back(parser->GetSwitchValue(ComparisonFilePatternArg, 0));
- break;
- default:
- return AZ::Failure(AZStd::string::format(
- "Invalid command: when using the \"--%s\" arg, the \"--%s\" arg can accept no more than one input value.",
- EditComparisonStepArg, ComparisonFilePatternArg));
- break;
- }
- }
- if (parser->HasSwitch(ComparisonTokenNameArg))
- {
- AZStd::string tokenName;
- size_t numTokenNames = parser->GetNumSwitchValues(ComparisonTokenNameArg);
- switch (numTokenNames)
- {
- case 0:
- // Our CLI parser will not return empty strings, so we need an extra case to check if a user wants to remove a Token altogether
- params.m_tokenNamesList.emplace_back("");
- break;
- case 1:
- tokenName = parser->GetSwitchValue(ComparisonTokenNameArg, 0);
- AzToolsFramework::AssetFileInfoListComparison::FormatOutputToken(tokenName);
- params.m_tokenNamesList.emplace_back(tokenName);
- break;
- default:
- return AZ::Failure(AZStd::string::format(
- "Invalid command: when using the \"--%s\" arg, the \"--%s\" arg can accept no more than one input value.",
- EditComparisonStepArg, ComparisonTokenNameArg));
- break;
- }
- }
- return AZ::Success();
- }
- AZ::Outcome<void, AZStd::string> ApplicationManager::ParseComparisonRulesFirstAndSecondInputArgs(const AZ::CommandLine* parser, ComparisonRulesParams& params)
- {
- if (params.m_comparisonTypeList.size() > 1 && (parser->HasSwitch(ComparisonFirstInputArg) || parser->HasSwitch(ComparisonSecondInputArg)))
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: the \"--%s\" and \"--%s\" args can only operate on one Comparison Step at a time.",
- ComparisonFirstInputArg, ComparisonSecondInputArg));
- }
- size_t numInputs;
- AZStd::string inputStr;
- if (parser->HasSwitch(ComparisonFirstInputArg))
- {
- numInputs = parser->GetNumSwitchValues(ComparisonFirstInputArg);
- switch (numInputs)
- {
- case 0:
- // Our CLI parser will not return empty strings, so we need an extra case to check if a user wants to remove an input altogether
- params.m_firstInputList.emplace_back("");
- break;
- case 1:
- inputStr = parser->GetSwitchValue(ComparisonFirstInputArg, 0);
- if (LooksLikePath(inputStr))
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: the \"--%s\" arg only accepts Tokens as inputs. Paths are not valid inputs.",
- ComparisonFirstInputArg));
- }
- AzToolsFramework::AssetFileInfoListComparison::FormatOutputToken(inputStr);
- params.m_firstInputList.emplace_back(inputStr);
- break;
- default:
- return AZ::Failure(AZStd::string::format(
- "Invalid command: when using the \"--%s\" arg, the \"--%s\" arg can accept no more than one input value.",
- EditComparisonStepArg, ComparisonFirstInputArg));
- break;
- }
- }
- if (parser->HasSwitch(ComparisonSecondInputArg))
- {
- numInputs = parser->GetNumSwitchValues(ComparisonSecondInputArg);
- switch (numInputs)
- {
- case 0:
- // Our CLI parser will not return empty strings, so we need an extra case to check if a user wants to remove an input altogether
- params.m_secondInputList.emplace_back("");
- break;
- case 1:
- inputStr = parser->GetSwitchValue(ComparisonSecondInputArg, 0);
- if (LooksLikePath(inputStr))
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid command: the \"--%s\" arg only accepts Tokens as inputs. Paths are not valid inputs.",
- ComparisonSecondInputArg));
- }
- AzToolsFramework::AssetFileInfoListComparison::FormatOutputToken(inputStr);
- params.m_secondInputList.emplace_back(inputStr);
- break;
- default:
- return AZ::Failure(AZStd::string::format(
- "Invalid command: when using the \"--%s\" arg, the \"--%s\" arg can accept no more than one input value.",
- EditComparisonStepArg, ComparisonSecondInputArg));
- break;
- }
- }
- return AZ::Success();
- }
- AZ::Outcome<ComparisonParams, AZStd::string> ApplicationManager::ParseCompareCommandData(const AZ::CommandLine* parser)
- {
- auto validateArgsOutcome = ValidateInputArgs(parser, m_allCompareArgs);
- if (!validateArgsOutcome.IsSuccess())
- {
- OutputHelpCompare();
- return AZ::Failure(validateArgsOutcome.TakeError());
- }
- ComparisonParams params;
- // Read in Platform arg
- auto platformOutcome = GetPlatformArg(parser);
- if (!platformOutcome.IsSuccess())
- {
- return AZ::Failure(platformOutcome.GetError());
- }
- params.m_platformFlags = GetInputPlatformFlagsOrEnabledPlatformFlags(platformOutcome.GetValue());
- AZStd::string inferredPlatform;
- // read in input files (first and second)
- for (size_t idx = 0; idx < parser->GetNumSwitchValues(CompareFirstFileArg); idx++)
- {
- AZStd::string value = parser->GetSwitchValue(CompareFirstFileArg, idx);
- if (!value.starts_with(compareVariablePrefix)) // Don't make this a path if it starts with the variable prefix
- {
- FilePath path = FilePath(value);
- value = path.AbsolutePath();
- inferredPlatform = AzToolsFramework::GetPlatformIdentifier(value);
- }
- params.m_firstCompareFile.emplace_back(AZStd::move(value));
- }
- for (size_t idx = 0; idx < parser->GetNumSwitchValues(CompareSecondFileArg); idx++)
- {
- AZStd::string value = parser->GetSwitchValue(CompareSecondFileArg, idx);
- if (!value.starts_with(compareVariablePrefix)) // Don't make this a path if it starts with the variable prefix
- {
- FilePath path = FilePath(value);
- value = path.AbsolutePath();
- }
- params.m_secondCompareFile.emplace_back(AZStd::move(value));
- }
- // read in output files
- for (size_t idx = 0; idx < parser->GetNumSwitchValues(CompareOutputFileArg); idx++)
- {
- AZStd::string value = parser->GetSwitchValue(CompareOutputFileArg, idx);
- if (!value.starts_with(compareVariablePrefix)) // Don't make this a path if it starts with the variable prefix
- {
- FilePath path = FilePath(value, inferredPlatform);
- value = path.AbsolutePath();
- }
- params.m_outputs.emplace_back(AZStd::move(value));
- }
- // Make Path object for existing rules file to load
- AZ::Outcome< AZStd::string, AZStd::string> pathArgOutcome = GetFilePathArg(parser, ComparisonRulesFileArg, CompareCommand, false);
- if (!pathArgOutcome.IsSuccess())
- {
- return AZ::Failure(pathArgOutcome.GetError());
- }
- params.m_comparisonRulesFile = FilePath(pathArgOutcome.GetValue());
- // Parse info for additional rules
- auto comparisonParseOutcome = ParseComparisonTypesAndPatterns(parser, params.m_comparisonRulesParams);
- if (!comparisonParseOutcome.IsSuccess())
- {
- return AZ::Failure(comparisonParseOutcome.GetError());
- }
- for (size_t idx = 0; idx < parser->GetNumSwitchValues(ComparePrintArg); idx++)
- {
- AZStd::string value = parser->GetSwitchValue(ComparePrintArg, idx);
- if (!value.starts_with(compareVariablePrefix)) // Don't make this a path if it starts with the variable prefix
- {
- FilePath path = FilePath(value);
- value = path.AbsolutePath();
- }
- params.m_printComparisons.emplace_back(AZStd::move(value));
- }
- params.m_printLast = parser->HasSwitch(ComparePrintArg) && params.m_printComparisons.empty();
- if (params.m_comparisonRulesParams.m_intersectionCount && (params.m_outputs.size() != 0 && params.m_outputs.size() != 1))
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" must have either be 0 or 1 value for compare operation of type ( %s ).",
- CompareOutputFileArg, AzToolsFramework::AssetFileInfoListComparison::ComparisonTypeNames[aznumeric_cast<AZ::u8>(AzToolsFramework::AssetFileInfoListComparison::ComparisonType::IntersectionCount)]));
- }
- // Read in Allow Overwrites flag
- params.m_allowOverwrites = parser->HasSwitch(AllowOverwritesFlag);
- return AZ::Success(params);
- }
- AZ::Outcome<BundleSettingsParams, AZStd::string> ApplicationManager::ParseBundleSettingsCommandData(const AZ::CommandLine* parser)
- {
- auto validateArgsOutcome = ValidateInputArgs(parser, m_allBundleSettingsArgs);
- if (!validateArgsOutcome.IsSuccess())
- {
- OutputHelpBundleSettings();
- return AZ::Failure(validateArgsOutcome.TakeError());
- }
- BundleSettingsParams params;
- // Read in Platform arg
- auto platformOutcome = GetPlatformArg(parser);
- if (!platformOutcome.IsSuccess())
- {
- return AZ::Failure(platformOutcome.GetError());
- }
- params.m_platformFlags = GetInputPlatformFlagsOrEnabledPlatformFlags(platformOutcome.GetValue());
- // Read in Bundle Settings File arg
- auto requiredArgOutcome = GetFilePathArg(parser, BundleSettingsFileArg, BundleSettingsCommand, true);
- if (!requiredArgOutcome.IsSuccess())
- {
- return AZ::Failure(requiredArgOutcome.GetError());
- }
- params.m_bundleSettingsFile = FilePath(requiredArgOutcome.GetValue());
- // Read in Asset List File arg
- auto argOutcome = GetFilePathArg(parser, AssetListFileArg, BundleSettingsCommand);
- if (!argOutcome.IsSuccess())
- {
- return AZ::Failure(argOutcome.GetError());
- }
- if (!argOutcome.GetValue().empty())
- {
- params.m_assetListFile = FilePath(argOutcome.GetValue());
- }
- // Read in Output Bundle Path arg
- argOutcome = GetFilePathArg(parser, OutputBundlePathArg, BundleSettingsCommand);
- if (!argOutcome.IsSuccess())
- {
- return AZ::Failure(argOutcome.GetError());
- }
- if (!argOutcome.GetValue().empty())
- {
- params.m_outputBundlePath = FilePath(argOutcome.GetValue());
- }
- // Read in Bundle Version arg
- if (parser->HasSwitch(BundleVersionArg))
- {
- if (parser->GetNumSwitchValues(BundleVersionArg) != 1)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" must have exactly one value.", BundleVersionArg));
- }
- params.m_bundleVersion = AZStd::stoi(parser->GetSwitchValue(BundleVersionArg, 0));
- }
- // Read in Max Bundle Size arg
- if (parser->HasSwitch(MaxBundleSizeArg))
- {
- if (parser->GetNumSwitchValues(MaxBundleSizeArg) != 1)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" must have exactly one value.", MaxBundleSizeArg));
- }
- params.m_maxBundleSizeInMB = AZStd::stoi(parser->GetSwitchValue(MaxBundleSizeArg, 0));
- }
- // Read in Print flag
- params.m_print = parser->HasSwitch(PrintFlag);
- return AZ::Success(params);
- }
- AZ::Outcome<BundlesParamsList, AZStd::string> ApplicationManager::ParseBundleSettingsAndOverrides(const AZ::CommandLine* parser, const char* commandName)
- {
- // Read in Bundle Settings File args
- auto bundleSettingsOutcome = GetArgsList<FilePath>(parser, BundleSettingsFileArg, commandName);
- if (!bundleSettingsOutcome.IsSuccess())
- {
- return AZ::Failure(bundleSettingsOutcome.GetError());
- }
- // Read in Asset List File args
- auto assetListOutcome = GetArgsList<FilePath>(parser, AssetListFileArg, commandName);
- if (!assetListOutcome.IsSuccess())
- {
- return AZ::Failure(assetListOutcome.GetError());
- }
- // Read in Output Bundle Path args
- auto bundleOutputPathOutcome = GetArgsList<FilePath>(parser, OutputBundlePathArg, commandName);
- if (!bundleOutputPathOutcome.IsSuccess())
- {
- return AZ::Failure(bundleOutputPathOutcome.GetError());
- }
- AZStd::vector<FilePath> bundleSettingsFileList = bundleSettingsOutcome.TakeValue();
- AZStd::vector<FilePath> assetListFileList = assetListOutcome.TakeValue();
- AZStd::vector<FilePath> outputBundleFileList = bundleOutputPathOutcome.TakeValue();
- size_t bundleSettingListSize = bundleSettingsFileList.size();
- size_t assetFileListSize = assetListFileList.size();
- size_t outputBundleListSize = outputBundleFileList.size();
- // * We are validating the following cases here
- // * AssetFileList should always be equal to outputBundleList size even if they are of zero length.
- // * BundleSettingList can be a zero size list if the number of elements in assetFileList matches the number of elements in outputBundleList.
- // * If bundleSettingList contains non zero elements than either it should have the same number of elements as in assetFileList or the number of elements in assetFileList should be zero.
- if (bundleSettingListSize)
- {
- if (assetFileListSize != outputBundleListSize)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" and \"--%s\" are required and should contain the same number of args.", AssetListFileArg, OutputBundlePathArg));
- }
- else if (bundleSettingListSize != assetFileListSize && assetFileListSize != 0)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\", \"--%s\" and \"--%s\" should contain the same number of args.", BundleSettingsFileArg, AssetListFileArg, OutputBundlePathArg));
- }
- }
- else
- {
- if (assetFileListSize != outputBundleListSize)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" and \"--%s\" are required and should contain the same number of args.", AssetListFileArg, OutputBundlePathArg));
- }
- }
- size_t expectedListSize = AZStd::max(assetFileListSize, bundleSettingListSize);
- // Read in Bundle Version args
- auto bundleVersionOutcome = GetArgsList<AZStd::string>(parser, BundleVersionArg, commandName);
- if (!bundleVersionOutcome.IsSuccess())
- {
- return AZ::Failure(bundleVersionOutcome.GetError());
- }
- AZStd::vector<AZStd::string> bundleVersionList = bundleVersionOutcome.TakeValue();
- size_t bundleVersionListSize = bundleVersionList.size();
- if (bundleVersionListSize != expectedListSize && bundleVersionListSize >= 2)
- {
- if (expectedListSize != 1)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: Number of args in \"--%s\" can either be zero, one or %zu. Actual size detected %zu.", BundleVersionArg, expectedListSize, bundleVersionListSize));
- }
- else
- {
- return AZ::Failure(AZStd::string::format("Invalid command: Number of args in \"--%s\" is %zu. Expected number of args is one.", BundleVersionArg, bundleVersionListSize ));
- }
- }
- // Read in Max Bundle Size args
- auto maxBundleSizeOutcome = GetArgsList<AZStd::string>(parser, MaxBundleSizeArg, commandName);
- if (!maxBundleSizeOutcome.IsSuccess())
- {
- return AZ::Failure(maxBundleSizeOutcome.GetError());
- }
- AZStd::vector<AZStd::string> maxBundleSizeList = maxBundleSizeOutcome.TakeValue();
- size_t maxBundleListSize = maxBundleSizeList.size();
- if (maxBundleListSize != expectedListSize && maxBundleListSize >= 2)
- {
- if (expectedListSize != 1)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: Number of args in \"--%s\" can either be zero, one or %zu. Actual size detected %zu.", MaxBundleSizeArg, expectedListSize, maxBundleListSize));
- }
- else
- {
- return AZ::Failure(AZStd::string::format("Invalid command: Number of args in \"--%s\" is %zu. Expected number of args is one.", MaxBundleSizeArg, maxBundleListSize));
- }
- }
- // Read in Platform arg
- auto platformOutcome = GetPlatformArg(parser);
- if (!platformOutcome.IsSuccess())
- {
- return AZ::Failure(platformOutcome.GetError());
- }
- // Read in Allow Overwrites flag
- bool allowOverwrites = parser->HasSwitch(AllowOverwritesFlag);
- BundlesParamsList bundleParamsList;
- for (int idx = 0; idx < expectedListSize; idx++)
- {
- BundlesParams bundleParams;
- bundleParams.m_bundleSettingsFile = bundleSettingListSize ? bundleSettingsFileList[idx] : FilePath();
- bundleParams.m_assetListFile = assetFileListSize ? assetListFileList[idx] : FilePath();
- bundleParams.m_outputBundlePath = outputBundleListSize ? outputBundleFileList[idx] : FilePath();
- if (bundleVersionListSize)
- {
- bundleParams.m_bundleVersion = bundleVersionListSize == 1 ? AZStd::stoi(bundleVersionList[0]) : AZStd::stoi(bundleVersionList[idx]);
- }
- if (maxBundleListSize)
- {
- bundleParams.m_maxBundleSizeInMB = maxBundleListSize == 1 ? AZStd::stoi(maxBundleSizeList[0]) : AZStd::stoi(maxBundleSizeList[idx]);
- }
- bundleParams.m_platformFlags = platformOutcome.GetValue();
- bundleParams.m_allowOverwrites = allowOverwrites;
- bundleParamsList.emplace_back(bundleParams);
- }
- return AZ::Success(bundleParamsList);
- }
- AZ::Outcome<BundlesParamsList, AZStd::string> ApplicationManager::ParseBundlesCommandData(const AZ::CommandLine* parser)
- {
- auto validateArgsOutcome = ValidateInputArgs(parser, m_allBundlesArgs);
- if (!validateArgsOutcome.IsSuccess())
- {
- OutputHelpBundles();
- return AZ::Failure(validateArgsOutcome.TakeError());
- }
- auto parseSettingsOutcome = ParseBundleSettingsAndOverrides(parser, BundlesCommand);
- if (!parseSettingsOutcome.IsSuccess())
- {
- return AZ::Failure(parseSettingsOutcome.GetError());
- }
- return AZ::Success(parseSettingsOutcome.TakeValue());
- }
- AZ::Outcome<BundleSeedParams, AZStd::string> ApplicationManager::ParseBundleSeedCommandData(const AZ::CommandLine* parser)
- {
- auto validateArgsOutcome = ValidateInputArgs(parser, m_allBundleSeedArgs);
- if (!validateArgsOutcome.IsSuccess())
- {
- OutputHelpBundleSeed();
- return AZ::Failure(validateArgsOutcome.TakeError());
- }
- BundleSeedParams params;
- params.m_addSeedList = GetAddSeedArgList(parser);
- auto parseSettingsOutcome = ParseBundleSettingsAndOverrides(parser, BundleSeedCommand);
- if (!parseSettingsOutcome.IsSuccess())
- {
- return AZ::Failure(parseSettingsOutcome.GetError());
- }
- BundlesParamsList paramsList = parseSettingsOutcome.TakeValue();
- params.m_bundleParams = paramsList[0];
- return AZ::Success(params);
- }
- AZ::Outcome<void, AZStd::string> ApplicationManager::ValidateInputArgs(const AZ::CommandLine* parser, const AZStd::vector<const char*>& validArgList)
- {
- constexpr AZStd::string_view ApplicationArgList = "/O3DE/AzCore/Application/ValidCommandOptions";
- AZStd::vector<AZStd::string> validApplicationArgs;
- if (auto settingsRegistry = AZ::SettingsRegistry::Get(); settingsRegistry != nullptr)
- {
- settingsRegistry->GetObject(validApplicationArgs, ApplicationArgList);
- }
- for (const auto& paramInfo : *parser)
- {
- // Skip positional arguments
- if (paramInfo.m_option.empty())
- {
- continue;
- }
- bool isValidArg = false;
- for (const auto& validArg : validArgList)
- {
- if (AZ::StringFunc::Equal(paramInfo.m_option, validArg))
- {
- isValidArg = true;
- break;
- }
- }
- for (const auto& validArg : validApplicationArgs)
- {
- if (AZ::StringFunc::Equal(paramInfo.m_option, validArg))
- {
- isValidArg = true;
- break;
- }
- }
- if (!isValidArg)
- {
- return AZ::Failure(AZStd::string::format(R"(Invalid argument: "--%s" is not a valid argument for this sub-command.)", paramInfo.m_option.c_str()));
- }
- }
- return AZ::Success();
- }
- AZ::Outcome<AZStd::string, AZStd::string> ApplicationManager::GetFilePathArg(const AZ::CommandLine* parser, const char* argName, const char* subCommandName, bool isRequired)
- {
- if (!parser->HasSwitch(argName))
- {
- if (isRequired)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" is required when running \"%s\".", argName, subCommandName));
- }
- return AZ::Success(AZStd::string());
- }
- if (parser->GetNumSwitchValues(argName) != 1)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" must have exactly one value.", argName));
- }
- return AZ::Success(parser->GetSwitchValue(argName, 0));
- }
-
- template <typename T>
- AZ::Outcome<AZStd::vector<T>, AZStd::string> ApplicationManager::GetArgsList(const AZ::CommandLine* parser, const char* argName, const char* subCommandName, bool isRequired)
- {
- AZStd::vector<T> args;
- if (!parser->HasSwitch(argName))
- {
- if (isRequired)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" is required when running \"%s\".", argName, subCommandName));
- }
- return AZ::Success(args);
- }
- size_t numValues = parser->GetNumSwitchValues(argName);
- for (int idx = 0; idx < numValues; ++idx)
- {
- args.emplace_back(T(parser->GetSwitchValue(argName, idx)));
- }
- return AZ::Success(args);
- }
- AZ::Outcome<AzFramework::PlatformFlags, AZStd::string> ApplicationManager::GetPlatformArg(const AZ::CommandLine* parser)
- {
- using namespace AzFramework;
- PlatformFlags platform = AzFramework::PlatformFlags::Platform_NONE;
- if (!parser->HasSwitch(PlatformArg))
- {
- return AZ::Success(platform);
- }
- size_t numValues = parser->GetNumSwitchValues(PlatformArg);
- if (numValues <= 0)
- {
- return AZ::Failure(AZStd::string::format("Invalid command: \"--%s\" must have at least one value.", PlatformArg));
- }
- for (int platformIdx = 0; platformIdx < numValues; ++platformIdx)
- {
- AZStd::string platformStr = parser->GetSwitchValue(PlatformArg, platformIdx);
- platform |= AzFramework::PlatformHelper::GetPlatformFlag(platformStr);
- }
- return AZ::Success(platform);
- }
- AzFramework::PlatformFlags ApplicationManager::GetInputPlatformFlagsOrEnabledPlatformFlags(AzFramework::PlatformFlags inputPlatformFlags)
- {
- using namespace AzToolsFramework;
- if (inputPlatformFlags != AzFramework::PlatformFlags::Platform_NONE)
- {
- return inputPlatformFlags;
- }
- // If no platform was specified, defaulting to platforms specified in the asset processor config files
- AzFramework::PlatformFlags platformFlags = GetEnabledPlatformFlags(
- AZStd::string_view{ AZ::Utils::GetEnginePath() },
- AZStd::string_view{ AZ::Utils::GetProjectPath() });
- [[maybe_unused]] auto platformsString = AzFramework::PlatformHelper::GetCommaSeparatedPlatformList(platformFlags);
- AZ_TracePrintf(AppWindowName, "No platform specified, defaulting to platforms ( %s ).\n", platformsString.c_str());
- return platformFlags;
- }
- AZStd::vector<AZStd::string> ApplicationManager::GetAddSeedArgList(const AZ::CommandLine* parser)
- {
- AZStd::vector<AZStd::string> addSeedList;
- size_t numAddSeedArgs = parser->GetNumSwitchValues(AddSeedArg);
- for (size_t addSeedIndex = 0; addSeedIndex < numAddSeedArgs; ++addSeedIndex)
- {
- addSeedList.push_back(parser->GetSwitchValue(AddSeedArg, addSeedIndex));
- }
- return addSeedList;
- }
- AZStd::vector<AZStd::string> ApplicationManager::GetSkipArgList(const AZ::CommandLine* parser)
- {
- AZStd::vector<AZStd::string> skipList;
- size_t numArgs = parser->GetNumSwitchValues(SkipArg);
- for (size_t argIndex = 0; argIndex < numArgs; ++argIndex)
- {
- skipList.push_back(parser->GetSwitchValue(SkipArg, argIndex));
- }
- return skipList;
- }
- bool ApplicationManager::SeedsOperationRequiresCatalog(const SeedsParams& params)
- {
- return params.m_addSeedList.size() || params.m_addPlatformToAllSeeds || params.m_updateSeedPathHint || params.m_print;
- }
- ////////////////////////////////////////////////////////////////////////////////////////////
- // Run Commands
- ////////////////////////////////////////////////////////////////////////////////////////////
- bool ApplicationManager::RunSeedsCommands(const AZ::Outcome<SeedsParams, AZStd::string>& paramsOutcome)
- {
- using namespace AzFramework;
- if (!paramsOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, paramsOutcome.GetError().c_str());
- return false;
- }
- SeedsParams params = paramsOutcome.GetValue();
- if (SeedsOperationRequiresCatalog(params))
- {
- // Asset Catalog
- auto catalogOutcome = InitAssetCatalog(params.m_platformFlags, params.m_assetCatalogFile.AbsolutePath());
- if (!catalogOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, catalogOutcome.GetError().c_str());
- return false;
- }
- }
- // Seed List File
- auto seedOutcome = LoadSeedListFile(params.m_seedListFile.AbsolutePath(), params.m_platformFlags);
- if (!seedOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, seedOutcome.GetError().c_str());
- return false;
- }
- for (const PlatformId platformId : AzFramework::PlatformHelper::GetPlatformIndices(params.m_platformFlags))
- {
- // Add Seeds
- PlatformFlags platformFlag = AzFramework::PlatformHelper::GetPlatformFlagFromPlatformIndex(platformId);
- for (const AZStd::string& assetPath : params.m_addSeedList)
- {
- m_assetSeedManager->AddSeedAsset(assetPath, platformFlag);
- }
- // Remove Seeds
- for (const AZStd::string& assetPath : params.m_removeSeedList)
- {
- m_assetSeedManager->RemoveSeedAsset(assetPath, platformFlag);
- }
- // Add Platform to All Seeds
- if (params.m_addPlatformToAllSeeds)
- {
- m_assetSeedManager->AddPlatformToAllSeeds(platformId);
- }
- // Remove Platform from All Seeds
- if (params.m_removePlatformFromAllSeeds)
- {
- m_assetSeedManager->RemovePlatformFromAllSeeds(platformId);
- }
- }
- if (params.m_updateSeedPathHint)
- {
- m_assetSeedManager->UpdateSeedPath();
- }
- if (params.m_removeSeedPathHint)
- {
- m_assetSeedManager->RemoveSeedPath();
- }
- if (params.m_print)
- {
- PrintSeedList(params.m_seedListFile.AbsolutePath());
- }
- // Save
- AZ_TracePrintf(AssetBundler::AppWindowName, "Saving Seed List to ( %s )...\n", params.m_seedListFile.AbsolutePath().c_str());
- if (!m_assetSeedManager->Save(params.m_seedListFile.AbsolutePath()))
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Unable to save Seed List to ( %s ).", params.m_seedListFile.AbsolutePath().c_str());
- return false;
- }
- AZ_TracePrintf(AssetBundler::AppWindowName, "Save successful!\n");
- return true;
- }
- bool ApplicationManager::RunAssetListsCommands(const AZ::Outcome<AssetListsParams, AZStd::string>& paramsOutcome)
- {
- using namespace AzFramework;
- if (!paramsOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, paramsOutcome.GetError().c_str());
- return false;
- }
- AssetListsParams params = paramsOutcome.GetValue();
- // Asset Catalog
- auto catalogOutcome = InitAssetCatalog(params.m_platformFlags, params.m_assetCatalogFile.AbsolutePath());
- if (!catalogOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, catalogOutcome.GetError().c_str());
- return false;
- }
- // Seed List Files
- AZ::Outcome<void, AZStd::string> seedListOutcome;
- AZStd::string seedListFileAbsolutePath;
- for (const FilePath& seedListFile : params.m_seedListFiles)
- {
- seedListFileAbsolutePath = seedListFile.AbsolutePath();
- if (!AZ::IO::FileIOBase::GetInstance()->Exists(seedListFileAbsolutePath.c_str()))
- {
- AZ_Error(AppWindowName, false, "Cannot load Seed List file ( %s ): File does not exist.\n", seedListFileAbsolutePath.c_str());
- return false;
- }
- seedListOutcome = LoadSeedListFile(seedListFileAbsolutePath, params.m_platformFlags);
- if (!seedListOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, seedListOutcome.GetError().c_str());
- return false;
- }
- }
- // Add Default Seed List Files
- if (params.m_addDefaultSeedListFiles)
- {
- AZStd::unordered_map<AZStd::string, AZStd::string> defaultSeedListFiles = GetDefaultSeedListFiles(GetEngineRoot(), AZ::Utils::GetProjectPath(),
- m_gemInfoList, params.m_platformFlags);
- if (defaultSeedListFiles.empty())
- {
- // Error has already been thrown
- return false;
- }
- for (const auto& seedListFile : defaultSeedListFiles)
- {
- seedListOutcome = LoadSeedListFile(seedListFile.first, params.m_platformFlags);
- if (!seedListOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, seedListOutcome.GetError().c_str());
- return false;
- }
- }
- AZStd::vector<AZStd::string> defaultSeeds = GetDefaultSeeds(AZ::Utils::GetProjectPath(), m_currentProjectName);
- if (defaultSeeds.empty())
- {
- // Error has already been thrown
- return false;
- }
- for (const auto& seed : defaultSeeds)
- {
- m_assetSeedManager->AddSeedAsset(seed, params.m_platformFlags);
- }
- }
- if (!RunPlatformSpecificAssetListCommands(params, params.m_platformFlags))
- {
- return false;
- }
- return true;
- }
- bool ApplicationManager::RunComparisonRulesCommands(const AZ::Outcome<ComparisonRulesParams, AZStd::string>& paramsOutcome)
- {
- using namespace AzToolsFramework;
- if (!paramsOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, paramsOutcome.GetError().c_str());
- return false;
- }
- ComparisonRulesParams params = paramsOutcome.GetValue();
- AssetFileInfoListComparison comparisonOperations;
- // Read the input ComparisonRules file into memory. If it does not already exist, we are going to create a new file.
- if (AZ::IO::FileIOBase::GetInstance()->Exists(params.m_comparisonRulesFile.AbsolutePath().c_str()))
- {
- auto rulesFileLoadOutcome = AssetFileInfoListComparison::Load(params.m_comparisonRulesFile.AbsolutePath());
- if (!rulesFileLoadOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, rulesFileLoadOutcome.GetError().c_str());
- return false;
- }
- comparisonOperations = rulesFileLoadOutcome.GetValue();
- }
- // Perform any editing operations (no need to throw errors on failure, they are already thrown elsewhere)
- switch (params.m_comparisonRulesStepAction)
- {
- case(ComparisonRulesStepAction::Add):
- if (!ConvertRulesParamsToComparisonData(params, comparisonOperations, params.m_destinationLine))
- {
- return false;
- }
- break;
- case(ComparisonRulesStepAction::AddToEnd):
- if (!ConvertRulesParamsToComparisonData(params, comparisonOperations, comparisonOperations.GetNumComparisonSteps()))
- {
- return false;
- }
- break;
- case(ComparisonRulesStepAction::Remove):
- if (!comparisonOperations.RemoveComparisonStep(params.m_initialLine))
- {
- return false;
- }
- break;
- case(ComparisonRulesStepAction::Move):
- if (!comparisonOperations.MoveComparisonStep(params.m_initialLine, params.m_destinationLine))
- {
- return false;
- }
- break;
- case(ComparisonRulesStepAction::Edit):
- if (!EditComparisonData(params, comparisonOperations, params.m_initialLine))
- {
- return false;
- }
- break;
- }
- if (params.m_print)
- {
- PrintComparisonRules(comparisonOperations, params.m_comparisonRulesFile.AbsolutePath());
- }
- // Attempt to save
- if (params.m_comparisonRulesStepAction != ComparisonRulesStepAction::Default)
- {
- AZ_TracePrintf(AssetBundler::AppWindowName, "Saving Comparison Rules file to ( %s )...\n", params.m_comparisonRulesFile.AbsolutePath().c_str());
- if (!comparisonOperations.Save(params.m_comparisonRulesFile.AbsolutePath().c_str()))
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Failed to save Comparison Rules file ( %s ).", params.m_comparisonRulesFile.AbsolutePath().c_str());
- return false;
- }
- AZ_TracePrintf(AssetBundler::AppWindowName, "Save successful!\n");
- }
- return true;
- }
- bool ApplicationManager::ConvertRulesParamsToComparisonData(const ComparisonRulesParams& params, AzToolsFramework::AssetFileInfoListComparison& assetListComparison, size_t startingIndex)
- {
- using namespace AzToolsFramework;
- for (int idx = 0; idx < params.m_comparisonTypeList.size(); idx++)
- {
- AssetFileInfoListComparison::ComparisonData comparisonData;
- comparisonData.m_comparisonType = params.m_comparisonTypeList[idx];
- comparisonData.m_filePattern = params.m_filePatternList[idx];
- comparisonData.m_filePatternType = params.m_filePatternTypeList[idx];
- comparisonData.m_output = params.m_tokenNamesList[idx];
- comparisonData.m_intersectionCount = params.m_intersectionCount;
- if (!params.m_firstInputList.empty())
- {
- comparisonData.m_firstInput = params.m_firstInputList[idx];
- }
- if (comparisonData.m_comparisonType != AssetFileInfoListComparison::ComparisonType::FilePattern)
- {
- if (!params.m_secondInputList.empty())
- {
- comparisonData.m_secondInput = params.m_secondInputList[idx];
- }
- }
- if (!assetListComparison.AddComparisonStep(comparisonData, startingIndex))
- {
- // Error has already been thrown
- return false;
- }
- ++startingIndex;
- }
- return true;
- }
- bool ApplicationManager::EditComparisonData(const ComparisonRulesParams& params, AzToolsFramework::AssetFileInfoListComparison& assetListComparison, size_t index)
- {
- using namespace AzToolsFramework;
- // Errors are thrown by the Asset List Comparison functions, no need to write our own here
- if (!params.m_comparisonTypeList.empty() && !assetListComparison.SetComparisonType(index, params.m_comparisonTypeList[0]))
- {
- return false;
- }
- if (!params.m_filePatternTypeList.empty() && !assetListComparison.SetFilePatternType(index, params.m_filePatternTypeList[0]))
- {
- return false;
- }
- if (!params.m_filePatternList.empty() && !assetListComparison.SetFilePattern(index, params.m_filePatternList[0]))
- {
- return false;
- }
- if (!params.m_tokenNamesList.empty() && !assetListComparison.SetOutput(index, params.m_tokenNamesList[0]))
- {
- return false;
- }
- if (!params.m_firstInputList.empty() && !assetListComparison.SetFirstInput(index, params.m_firstInputList[0]))
- {
- return false;
- }
- if (!params.m_secondInputList.empty() && !assetListComparison.SetSecondInput(index, params.m_secondInputList[0]))
- {
- return false;
- }
- return true;
- }
- void ApplicationManager::PrintComparisonRules(const AzToolsFramework::AssetFileInfoListComparison& assetListComparison, const AZStd::string& comparisonRulesAbsoluteFilePath)
- {
- AZ_Printf(AppWindowName, "\nContents of: %s\n\n", comparisonRulesAbsoluteFilePath.c_str());
- const char* inputVariableMessage = "[input at runtime]";
- int lineNum = 0;
- for (const auto& comparisonData : assetListComparison.GetComparisonList())
- {
- const char* comparisonTypeName = AzToolsFramework::AssetFileInfoListComparison::ComparisonTypeNames[aznumeric_cast<AZ::u8>(comparisonData.m_comparisonType)];
- AZ_Printf(AppWindowName, "%-10i %-15s (%s", lineNum, comparisonTypeName, comparisonData.m_firstInput.empty() ? inputVariableMessage : comparisonData.m_firstInput.c_str());
- if (comparisonData.m_filePatternType != AzToolsFramework::AssetFileInfoListComparison::FilePatternType::Default)
- {
- AZ_Printf(AppWindowName, ")\n");
- const char* filePatternTypeName = AzToolsFramework::AssetFileInfoListComparison::FilePatternTypeNames[aznumeric_cast<AZ::u8>(comparisonData.m_filePatternType)];
- AZ_Printf(AppWindowName, "%-14s %s \"%s\"\n", "", filePatternTypeName, comparisonData.m_filePattern.c_str());
- }
- else
- {
- AZ_Printf(AppWindowName, ", %s )\n", comparisonData.m_secondInput.empty() ? inputVariableMessage : comparisonData.m_secondInput.c_str());
- }
- AZ_Printf(AppWindowName, "%-14s Output Token: %s\n", "", comparisonData.m_output.empty() ? "[No Token Set]" : comparisonData.m_output.c_str());
- ++lineNum;
- }
- AZ_Printf(AppWindowName, "\n");
- }
- bool ApplicationManager::IsDefaultToken(const AZStd::string& pathOrToken)
- {
- return pathOrToken.size() == 1 && pathOrToken.at(0) == compareVariablePrefix;
- }
- bool ApplicationManager::RunCompareCommand(const AZ::Outcome<ComparisonParams, AZStd::string>& paramsOutcome)
- {
- using namespace AzToolsFramework;
- if (!paramsOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, paramsOutcome.GetError().c_str());
- return false;
- }
- AssetFileInfoListComparison rulesFileComparisonOperations;
- // Load comparison rules from file if one was provided
- if (!paramsOutcome.GetValue().m_comparisonRulesFile.AbsolutePath().empty())
- {
- auto rulesFileLoadResult = AssetFileInfoListComparison::Load(paramsOutcome.GetValue().m_comparisonRulesFile.AbsolutePath());
- if (!rulesFileLoadResult.IsSuccess())
- {
- AZ_Error(AppWindowName, false, rulesFileLoadResult.GetError().c_str());
- return false;
- }
- rulesFileComparisonOperations = rulesFileLoadResult.GetValue();
- }
- bool hasError = false;
- for (AZStd::string platformName : AzFramework::PlatformHelper::GetPlatformsInterpreted(paramsOutcome.GetValue().m_platformFlags))
- {
- AZ_TracePrintf(AssetBundler::AppWindowName, "Running Compare command for the %s platform...\n", platformName.c_str());
- ComparisonParams params = paramsOutcome.GetValue();
- AddPlatformToAllComparisonParams(params, platformName);
- AssetFileInfoListComparison comparisonOperations = rulesFileComparisonOperations;
- // generate comparisons from additional commands and add it to comparisonOperations
- ConvertRulesParamsToComparisonData(params.m_comparisonRulesParams, comparisonOperations, comparisonOperations.GetNumComparisonSteps());
- if (params.m_comparisonRulesParams.m_intersectionCount)
- {
- if ((comparisonOperations.GetComparisonList().size() == 1) && comparisonOperations.GetComparisonList()[0].m_comparisonType != AssetFileInfoListComparison::ComparisonType::IntersectionCount)
- {
- AZ_Error(AppWindowName, false, "Invalid arguement detected. Command ( --%s ) is incompatible with compare operation of type (%s).",
- IntersectionCountArg, AssetFileInfoListComparison::ComparisonTypeNames[aznumeric_cast<AZ::u8>(comparisonOperations.GetComparisonList()[0].m_comparisonType)]);
- return false;
- }
- // Since IntersectionCount Operation cannot be combined with other operation Comparison List should be 1
- else if (comparisonOperations.GetComparisonList().size() > 1)
- {
- AZ_Error(AppWindowName, false, "Compare operation of type ( %s ) cannot be combined with other comparison operations. Number of comparison operation detected (%d).",
- AssetFileInfoListComparison::ComparisonTypeNames[aznumeric_cast<AZ::u8>(AssetFileInfoListComparison::ComparisonType::IntersectionCount)], comparisonOperations.GetComparisonList().size());
- return false;
- }
- if (params.m_outputs.size())
- {
- comparisonOperations.SetOutput(0, params.m_outputs[0]);
- }
- }
- else
- {
- //Store input and output values alongside the Comparison Steps they relate to
- size_t secondInputIdx = 0;
- for (size_t idx = 0; idx < comparisonOperations.GetComparisonList().size(); ++idx)
- {
- if (idx >= params.m_firstCompareFile.size())
- {
- AZ_Error(AppWindowName, false,
- "Invalid command: The number of \"--%s\" inputs ( %i ) must match the number of Comparison Steps ( %i ).",
- CompareFirstFileArg, params.m_firstCompareFile.size(), comparisonOperations.GetComparisonList().size());
- return false;
- }
- // Set the first input
- if (!IsDefaultToken(params.m_firstCompareFile.at(idx)))
- {
- comparisonOperations.SetFirstInput(idx, params.m_firstCompareFile.at(idx));
- }
- // Set the second input (if needed)
- if (comparisonOperations.GetComparisonList().at(idx).m_comparisonType != AssetFileInfoListComparison::ComparisonType::FilePattern)
- {
- if (secondInputIdx >= params.m_secondCompareFile.size())
- {
- AZ_Error(AppWindowName, false,
- "Invalid command: The number of \"--%s\" inputs ( %i ) must match the number of Comparison Steps that take two inputs.",
- CompareSecondFileArg, params.m_secondCompareFile.size());
- return false;
- }
- if (!IsDefaultToken(params.m_secondCompareFile.at(secondInputIdx)))
- {
- comparisonOperations.SetSecondInput(idx, params.m_secondCompareFile.at(secondInputIdx));
- }
- ++secondInputIdx;
- }
- // Set the output
- if (idx >= params.m_outputs.size())
- {
- AZ_Error(AppWindowName, false,
- "Invalid command: The number of \"--%s\" values ( %i ) must match the number of Comparison Steps ( %i ).",
- CompareOutputFileArg, params.m_outputs.size(), comparisonOperations.GetComparisonList().size());
- return false;
- }
- if (!IsDefaultToken(params.m_outputs.at(idx)))
- {
- comparisonOperations.SetOutput(idx, params.m_outputs.at(idx));
- }
- }
- }
- AZ::Outcome<AssetFileInfoList, AZStd::string> compareOutcome = comparisonOperations.Compare(params.m_firstCompareFile);
- if (!compareOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, compareOutcome.GetError().c_str());
- hasError = true;
- continue;
- }
- if (params.m_printLast)
- {
- PrintComparisonAssetList(compareOutcome.GetValue(), params.m_outputs.size() ? params.m_outputs.back() : "");
- }
- // Check if we are performing a destructive overwrite that the user did not approve
- if (!params.m_allowOverwrites)
- {
- AZStd::vector<AZStd::string> destructiveOverwriteFilePaths = comparisonOperations.GetDestructiveOverwriteFilePaths();
- if (!destructiveOverwriteFilePaths.empty())
- {
- #if defined(AZ_ENABLE_TRACING)
- for (const AZStd::string& path : destructiveOverwriteFilePaths)
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Asset List file ( %s ) already exists, running this command would perform a destructive overwrite.", path.c_str());
- }
- #endif
- AZ_Printf(AssetBundler::AppWindowName, "\nRun your command again with the ( --%s ) arg if you want to save over the existing file.\n\n", AllowOverwritesFlag)
- hasError = true;
- continue;
- }
- }
- AZ_Printf(AssetBundler::AppWindowName, "Saving results of comparison operation...\n");
- auto saveOutcome = comparisonOperations.SaveResults();
- if (!saveOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, saveOutcome.GetError().c_str());
- hasError = true;
- continue;
- }
- AZ_Printf(AssetBundler::AppWindowName, "Save successful!\n");
- for (const AZStd::string& comparisonKey : params.m_printComparisons)
- {
- PrintComparisonAssetList(comparisonOperations.GetComparisonResults(comparisonKey), comparisonKey);
- }
- }
- return !hasError;
- }
- void ApplicationManager::AddPlatformToAllComparisonParams(ComparisonParams& params, const AZStd::string& platformName)
- {
- for (size_t i = 0; i < params.m_firstCompareFile.size(); ++i)
- {
- AddPlatformToComparisonParam(params.m_firstCompareFile[i], platformName);
- }
- for (size_t i = 0; i < params.m_secondCompareFile.size(); ++i)
- {
- AddPlatformToComparisonParam(params.m_secondCompareFile[i], platformName);
- }
- for (size_t i = 0; i < params.m_outputs.size(); ++i)
- {
- AddPlatformToComparisonParam(params.m_outputs[i], platformName);
- }
- }
- void ApplicationManager::AddPlatformToComparisonParam(AZStd::string& inOut, const AZStd::string& platformName)
- {
- // Tokens don't have platforms
- if (AzToolsFramework::AssetFileInfoListComparison::IsTokenFile(inOut))
- {
- return;
- }
- AzToolsFramework::RemovePlatformIdentifier(inOut);
- FilePath tempPath(inOut, platformName);
- inOut = tempPath.AbsolutePath();
- }
- void ApplicationManager::PrintComparisonAssetList(const AzToolsFramework::AssetFileInfoList& infoList, const AZStd::string& resultName)
- {
- using namespace AzToolsFramework;
- if (infoList.m_fileInfoList.size() == 0)
- {
- return;
- }
- AZ_Printf(AssetBundler::AppWindowName, "Printing assets from the comparison result %s.\n", resultName.c_str());
- AZ_Printf(AssetBundler::AppWindowName, "------------------------------------------\n");
- for (const AssetFileInfo& assetFilenfo : infoList.m_fileInfoList)
- {
- AZ_Printf(AssetBundler::AppWindowName, "- %s\n", assetFilenfo.m_assetRelativePath.c_str());
- }
- AZ_Printf(AssetBundler::AppWindowName, "Total number of assets (%u).\n", infoList.m_fileInfoList.size());
- AZ_Printf(AssetBundler::AppWindowName, "---------------------------\n");
- }
- bool ApplicationManager::RunBundleSettingsCommands(const AZ::Outcome<BundleSettingsParams, AZStd::string>& paramsOutcome)
- {
- using namespace AzToolsFramework;
- if (!paramsOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, paramsOutcome.GetError().c_str());
- return false;
- }
- BundleSettingsParams params = paramsOutcome.GetValue();
- for (AZStd::string_view platformName : AzFramework::PlatformHelper::GetPlatformsInterpreted(params.m_platformFlags))
- {
- AssetBundleSettings bundleSettings;
- // Attempt to load Bundle Settings file. If the load operation fails, we are making a new file and there is no need to error.
- FilePath platformSpecificBundleSettingsFilePath = FilePath(params.m_bundleSettingsFile.AbsolutePath(), platformName);
- AZ::Outcome<AssetBundleSettings, AZStd::string> loadBundleSettingsOutcome = AssetBundleSettings::Load(platformSpecificBundleSettingsFilePath.AbsolutePath());
- if (loadBundleSettingsOutcome.IsSuccess())
- {
- bundleSettings = loadBundleSettingsOutcome.TakeValue();
- }
- // Asset List File
- AZStd::string assetListFilePath = FilePath(params.m_assetListFile.AbsolutePath(), platformName).AbsolutePath();
- if (!assetListFilePath.empty())
- {
- if (!AZ::StringFunc::EndsWith(assetListFilePath, AssetSeedManager::GetAssetListFileExtension()))
- {
- AZ_Error(AppWindowName, false, "Cannot set Asset List file to ( %s ): file extension must be ( %s ).", assetListFilePath.c_str(), AssetSeedManager::GetAssetListFileExtension());
- return false;
- }
- if (!AZ::IO::FileIOBase::GetInstance()->Exists(assetListFilePath.c_str()))
- {
- AZ_Error(AppWindowName, false, "Cannot set Asset List file to ( %s ): file does not exist.", assetListFilePath.c_str());
- return false;
- }
- // Make the path relative to the engine root folder before saving
- AZ::StringFunc::Replace(assetListFilePath, GetEngineRoot(), "");
- bundleSettings.m_assetFileInfoListPath = assetListFilePath;
- }
- // Output Bundle Path
- AZStd::string outputBundlePath = FilePath(params.m_outputBundlePath.AbsolutePath(), platformName).AbsolutePath();
- if (!outputBundlePath.empty())
- {
- if (!AZ::StringFunc::EndsWith(outputBundlePath, AssetBundleSettings::GetBundleFileExtension()))
- {
- AZ_Error(AppWindowName, false, "Cannot set Output Bundle Path to ( %s ): file extension must be ( %s ).", outputBundlePath.c_str(), AssetBundleSettings::GetBundleFileExtension());
- return false;
- }
- // Make the path relative to the engine root folder before saving
- AZ::StringFunc::Replace(outputBundlePath, GetEngineRoot(), "");
- bundleSettings.m_bundleFilePath = outputBundlePath;
- }
- // Bundle Version
- if (params.m_bundleVersion > 0 && params.m_bundleVersion <= AzFramework::AssetBundleManifest::CurrentBundleVersion)
- {
- bundleSettings.m_bundleVersion = params.m_bundleVersion;
- }
- // Max Bundle Size (in MB)
- if (params.m_maxBundleSizeInMB > 0 && params.m_maxBundleSizeInMB <= AssetBundleSettings::GetMaxBundleSizeInMB())
- {
- bundleSettings.m_maxBundleSizeInMB = params.m_maxBundleSizeInMB;
- }
- // Print
- if (params.m_print)
- {
- AZ_TracePrintf(AssetBundler::AppWindowName, "\nContents of Bundle Settings file ( %s ):\n", platformSpecificBundleSettingsFilePath.AbsolutePath().c_str());
- AZ_TracePrintf(AssetBundler::AppWindowName, " Platform: %.*s\n", aznumeric_cast<int>(platformName.size()), platformName.data());
- AZ_TracePrintf(AssetBundler::AppWindowName, " Asset List file: %s\n", bundleSettings.m_assetFileInfoListPath.c_str());
- AZ_TracePrintf(AssetBundler::AppWindowName, " Output Bundle path: %s\n", bundleSettings.m_bundleFilePath.c_str());
- AZ_TracePrintf(AssetBundler::AppWindowName, " Bundle Version: %i\n", bundleSettings.m_bundleVersion);
- AZ_TracePrintf(AssetBundler::AppWindowName, " Max Bundle Size: %u MB\n\n", bundleSettings.m_maxBundleSizeInMB);
- }
- // Save
- AZ_TracePrintf(AssetBundler::AppWindowName, "Saving Bundle Settings file to ( %s )...\n", platformSpecificBundleSettingsFilePath.AbsolutePath().c_str());
- if (!AssetBundleSettings::Save(bundleSettings, platformSpecificBundleSettingsFilePath.AbsolutePath()))
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Unable to save Bundle Settings file to ( %s ).", platformSpecificBundleSettingsFilePath.AbsolutePath().c_str());
- return false;
- }
- AZ_TracePrintf(AssetBundler::AppWindowName, "Save successful!\n");
- }
- return true;
- }
- bool ApplicationManager::RunBundlesCommands(const AZ::Outcome<BundlesParamsList, AZStd::string>& paramsOutcome)
- {
- using namespace AzToolsFramework;
- if (!paramsOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, paramsOutcome.GetError().c_str());
- return false;
- }
- BundlesParamsList paramsList = paramsOutcome.GetValue();
- AZStd::vector<AZStd::pair<AssetBundleSettings, BundlesParams>> allBundleSettings;
- for (BundlesParams& params : paramsList)
- {
- // If no platform was input we want to loop over all possible platforms and make bundles for whatever we find
- if (params.m_platformFlags == AzFramework::PlatformFlags::Platform_NONE)
- {
- params.m_platformFlags = AzFramework::PlatformFlags::AllNamedPlatforms;
- }
- // Load or generate Bundle Settings
- AzFramework::PlatformFlags allPlatformsInBundle = AzFramework::PlatformFlags::Platform_NONE;
- if (params.m_bundleSettingsFile.AbsolutePath().empty())
- {
- // Verify input file path formats before looking for platform-specific versions
- auto fileExtensionOutcome = AssetFileInfoList::ValidateAssetListFileExtension(params.m_assetListFile.AbsolutePath());
- if (!fileExtensionOutcome.IsSuccess())
- {
- AZ_Error(AssetBundler::AppWindowName, false, fileExtensionOutcome.GetError().c_str());
- return false;
- }
- if (!AZ::IO::FileIOBase::GetInstance()->Exists(params.m_assetListFile.AbsolutePath().c_str()))
- {
- AZ_Error(
- AppWindowName,
- false,
- "Cannot load Asset List file ( %.*s ): File does not exist.\n",
- AZ_STRING_ARG(params.m_assetListFile.AbsolutePath()));
- return false;
- }
- AZStd::vector<FilePath> allAssetListFilePaths = GetAllPlatformSpecificFilesOnDisk(params.m_assetListFile, params.m_platformFlags);
- // Create temporary Bundle Settings structs for every Asset List file
- for (const auto& assetListFilePath : allAssetListFilePaths)
- {
- AssetBundleSettings bundleSettings;
- bundleSettings.m_assetFileInfoListPath = assetListFilePath.AbsolutePath();
- bundleSettings.m_platform = GetPlatformIdentifier(assetListFilePath.AbsolutePath());
- allPlatformsInBundle |= AzFramework::PlatformHelper::GetPlatformFlag(bundleSettings.m_platform);
- allBundleSettings.emplace_back(AZStd::make_pair(bundleSettings, params));
- }
- }
- else
- {
- // Verify input file path formats before looking for platform-specific versions
- auto fileExtensionOutcome = AssetBundleSettings::ValidateBundleSettingsFileExtension(params.m_bundleSettingsFile.AbsolutePath());
- if (!fileExtensionOutcome.IsSuccess())
- {
- AZ_Error(AssetBundler::AppWindowName, false, fileExtensionOutcome.GetError().c_str());
- return false;
- }
- AZStd::vector<FilePath> allBundleSettingsFilePaths = GetAllPlatformSpecificFilesOnDisk(params.m_bundleSettingsFile, params.m_platformFlags);
- // Attempt to load all Bundle Settings files (there may be one or many to load)
- for (const auto& bundleSettingsFilePath : allBundleSettingsFilePaths)
- {
- AZ::Outcome<AssetBundleSettings, AZStd::string> loadBundleSettingsOutcome = AssetBundleSettings::Load(bundleSettingsFilePath.AbsolutePath());
- if (!loadBundleSettingsOutcome.IsSuccess())
- {
- AZ_Error(AssetBundler::AppWindowName, false, loadBundleSettingsOutcome.GetError().c_str());
- return false;
- }
- allBundleSettings.emplace_back(AZStd::make_pair(loadBundleSettingsOutcome.TakeValue(), params));
- allPlatformsInBundle |= AzFramework::PlatformHelper::GetPlatformFlag(allBundleSettings.back().first.m_platform);
- }
- }
- }
- AZStd::atomic_uint failureCount = 0;
- // Create all Bundles
- AZ::parallel_for_each(allBundleSettings.begin(), allBundleSettings.end(), [this, &failureCount](AZStd::pair<AzToolsFramework::AssetBundleSettings, BundlesParams> bundleSettings)
- {
- BundlesParams params = bundleSettings.second;
- auto overrideOutcome = ApplyBundleSettingsOverrides(
- bundleSettings.first,
- params.m_assetListFile.AbsolutePath(),
- params.m_outputBundlePath.AbsolutePath(),
- params.m_bundleVersion,
- params.m_maxBundleSizeInMB);
- if (!overrideOutcome.IsSuccess())
- {
- // Metric event has already been sent
- AZ_Error(AppWindowName, false, overrideOutcome.GetError().c_str());
- failureCount.fetch_add(1, AZStd::memory_order::memory_order_relaxed);
- return;
- }
- FilePath bundleFilePath(bundleSettings.first.m_bundleFilePath);
- // Check if we are performing a destructive overwrite that the user did not approve
- if (!params.m_allowOverwrites && AZ::IO::FileIOBase::GetInstance()->Exists(bundleFilePath.AbsolutePath().c_str()))
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Bundle ( %s ) already exists, running this command would perform a destructive overwrite.\n\n"
- "Run your command again with the ( --%s ) arg if you want to save over the existing file.", bundleFilePath.AbsolutePath().c_str(), AllowOverwritesFlag);
- failureCount.fetch_add(1, AZStd::memory_order::memory_order_relaxed);
- return;
- }
- AZ_TracePrintf(AssetBundler::AppWindowName, "Creating Bundle ( %s )...\n", bundleFilePath.AbsolutePath().c_str());
- bool result = false;
- AssetBundleCommandsBus::BroadcastResult(result, &AssetBundleCommandsBus::Events::CreateAssetBundle, bundleSettings.first);
- if (!result)
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Unable to create bundle, target Bundle file path is ( %s ).", bundleFilePath.AbsolutePath().c_str());
- failureCount.fetch_add(1, AZStd::memory_order::memory_order_relaxed);
- return;
- }
- AZ_TracePrintf(AssetBundler::AppWindowName, "Bundle ( %s ) created successfully!\n", bundleFilePath.AbsolutePath().c_str());
- });
- return failureCount == 0;
- }
- bool ApplicationManager::RunBundleSeedCommands(const AZ::Outcome<BundleSeedParams, AZStd::string>& paramsOutcome)
- {
- using namespace AzToolsFramework;
- if (!paramsOutcome.IsSuccess())
- {
- AZ_Error(AppWindowName, false, paramsOutcome.GetError().c_str());
- return false;
- }
- BundleSeedParams params = paramsOutcome.GetValue();
- // If no platform was input we want to loop over all possible platforms and make bundles for whatever we find
- if (params.m_bundleParams.m_platformFlags == AzFramework::PlatformFlags::Platform_NONE)
- {
- params.m_bundleParams.m_platformFlags = AzFramework::PlatformFlags::AllNamedPlatforms;
- }
- AZStd::vector<AssetBundleSettings> allBundleSettings;
- if (params.m_bundleParams.m_bundleSettingsFile.AbsolutePath().empty())
- {
- // if no bundle settings file was provided generate one for each platform, values will be overridden later
- for (AZStd::string_view platformName : AzFramework::PlatformHelper::GetPlatformsInterpreted(params.m_bundleParams.m_platformFlags))
- {
- allBundleSettings.emplace_back();
- allBundleSettings.back().m_platform = platformName;
- }
-
- }
- else
- {
- // if a bundle settings file was provided use values from the file, leave the asset list file path behind since it will be ignored anyways
- AZStd::vector<FilePath> allBundleSettingsFilePaths = GetAllPlatformSpecificFilesOnDisk(params.m_bundleParams.m_bundleSettingsFile, params.m_bundleParams.m_platformFlags);
- // Attempt to load all Bundle Settings files (there may be one or many to load)
- for (const auto& bundleSettingsFilePath : allBundleSettingsFilePaths)
- {
- AZ::Outcome<AssetBundleSettings, AZStd::string> loadBundleSettingsOutcome = AssetBundleSettings::Load(bundleSettingsFilePath.AbsolutePath());
- if (!loadBundleSettingsOutcome.IsSuccess())
- {
- AZ_Error(AssetBundler::AppWindowName, false, loadBundleSettingsOutcome.GetError().c_str());
- return false;
- }
- allBundleSettings.emplace_back(loadBundleSettingsOutcome.TakeValue());
- }
- }
- // Create all Bundles
- for (AssetBundleSettings& bundleSettings : allBundleSettings)
- {
- auto overrideOutcome = ApplyBundleSettingsOverrides(
- bundleSettings,
- params.m_bundleParams.m_assetListFile.AbsolutePath(),
- params.m_bundleParams.m_outputBundlePath.AbsolutePath(),
- params.m_bundleParams.m_bundleVersion,
- params.m_bundleParams.m_maxBundleSizeInMB);
- if (!overrideOutcome.IsSuccess())
- {
- // Metric event has already been sent
- AZ_Error(AppWindowName, false, overrideOutcome.GetError().c_str());
- return false;
- }
- if (!params.m_bundleParams.m_allowOverwrites && AZ::IO::FileIOBase::GetInstance()->Exists(bundleSettings.m_bundleFilePath.c_str()))
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Bundle ( %s ) already exists, running this command would perform a destructive overwrite.\n\n"
- "Run your command again with the ( --%s ) arg if you want to save over the existing file.", bundleSettings.m_bundleFilePath.c_str(), AllowOverwritesFlag);
- return false;
- }
- AzFramework::PlatformFlags platformFlag = AzFramework::PlatformHelper::GetPlatformFlag(bundleSettings.m_platform);
- AzFramework::PlatformId platformId = static_cast<AzFramework::PlatformId>(AzFramework::PlatformHelper::GetPlatformIndexFromName(bundleSettings.m_platform.c_str()));
- for (const AZStd::string& assetPath : params.m_addSeedList)
- {
- m_assetSeedManager->AddSeedAsset(assetPath, platformFlag);
- }
- auto assetList = m_assetSeedManager->GetDependenciesInfo(platformId, {});
- if (assetList.size() == 0)
- {
- AZ_TracePrintf(AssetBundler::AppWindowName, "Platform ( %s ) had no assets based on these seeds, skipping bundle generation.\n", bundleSettings.m_platform.c_str());
- }
- else
- {
- AssetFileInfoList assetFileInfoList;
- // convert from AZ::Data::AssetInfo to AssetFileInfo for AssetBundleAPI call
- for (const auto& asset : assetList)
- {
- AssetFileInfo assetInfo;
- assetInfo.m_assetId = asset.m_assetId;
- assetInfo.m_assetRelativePath = asset.m_relativePath;
- assetFileInfoList.m_fileInfoList.emplace_back(assetInfo);
- }
- AZ_TracePrintf(AssetBundler::AppWindowName, "Creating Bundle ( %s )...\n", bundleSettings.m_bundleFilePath.c_str());
- bool result = false;
- AssetBundleCommandsBus::BroadcastResult(result, &AssetBundleCommandsBus::Events::CreateAssetBundleFromList, bundleSettings, assetFileInfoList);
- if (!result)
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Unable to create bundle, target Bundle file path is ( %s ).", bundleSettings.m_bundleFilePath.c_str());
- return false;
- }
- AZ_TracePrintf(AssetBundler::AppWindowName, "Bundle ( %s ) created successfully!\n", bundleSettings.m_bundleFilePath.c_str());
- }
- }
- return true;
- }
- AZ::Outcome<void, AZStd::string> ApplicationManager::InitAssetCatalog(AzFramework::PlatformFlags platforms, const AZStd::string& assetCatalogFile)
- {
- using namespace AzToolsFramework;
- if (platforms == AzFramework::PlatformFlags::Platform_NONE)
- {
- return AZ::Failure(AZStd::string("Invalid platform.\n"));
- }
- for (const AzFramework::PlatformId& platformId : AzFramework::PlatformHelper::GetPlatformIndicesInterpreted(platforms))
- {
- AZStd::string platformSpecificAssetCatalogPath;
- if (assetCatalogFile.empty())
- {
- AZ::StringFunc::Path::ConstructFull(
- PlatformAddressedAssetCatalog::GetAssetRootForPlatform(platformId).c_str(),
- AssetBundler::AssetCatalogFilename,
- platformSpecificAssetCatalogPath);
- }
- else
- {
- platformSpecificAssetCatalogPath = assetCatalogFile;
- }
- AZ_TracePrintf(AssetBundler::AppWindowNameVerbose, "Loading asset catalog from ( %s ).\n", platformSpecificAssetCatalogPath.c_str());
- bool success = false;
- {
- AzToolsFramework::AssetCatalog::PlatformAddressedAssetCatalogRequestBus::EventResult(success, platformId, &AzToolsFramework::AssetCatalog::PlatformAddressedAssetCatalogRequestBus::Events::LoadCatalog, platformSpecificAssetCatalogPath.c_str());
- }
- if (!success && !AzFramework::PlatformHelper::IsSpecialPlatform(platforms))
- {
- return AZ::Failure(AZStd::string::format("Failed to open asset catalog file ( %s ).", platformSpecificAssetCatalogPath.c_str()));
- }
- }
- return AZ::Success();
- }
- AZ::Outcome<void, AZStd::string> ApplicationManager::LoadSeedListFile(const AZStd::string& seedListFileAbsolutePath, AzFramework::PlatformFlags platformFlags)
- {
- AZ::Outcome<void, AZStd::string> fileExtensionOutcome = AzToolsFramework::AssetSeedManager::ValidateSeedFileExtension(seedListFileAbsolutePath);
- if (!fileExtensionOutcome.IsSuccess())
- {
- return fileExtensionOutcome;
- }
- bool seedListFileExists = AZ::IO::FileIOBase::GetInstance()->Exists(seedListFileAbsolutePath.c_str());
- if (seedListFileExists)
- {
- AZ_TracePrintf(AssetBundler::AppWindowName, "Loading Seed List file ( %s ).\n", seedListFileAbsolutePath.c_str());
- if (!IsGemSeedFilePathValid(GetEngineRoot(), seedListFileAbsolutePath, m_gemInfoList, platformFlags))
- {
- return AZ::Failure(AZStd::string::format(
- "Invalid Seed List file ( %s ). This can happen if you add a seed file from a gem that is not enabled for the current project ( %s ).",
- seedListFileAbsolutePath.c_str(),
- m_currentProjectName.c_str()));
- }
- if (!m_assetSeedManager->Load(seedListFileAbsolutePath))
- {
- return AZ::Failure(AZStd::string::format("Failed to load Seed List file ( %s ).", seedListFileAbsolutePath.c_str()));
- }
- }
- return AZ::Success();
- }
- void ApplicationManager::PrintSeedList(const AZStd::string& seedListFileAbsolutePath)
- {
- AZ_Printf(AppWindowName, "\nContents of ( %s ):\n\n", seedListFileAbsolutePath.c_str());
- for (const AzFramework::SeedInfo& seed : m_assetSeedManager->GetAssetSeedList())
- {
- AZ_Printf(AppWindowName, "%-60s%s\n", seed.m_assetRelativePath.c_str(), m_assetSeedManager->GetReadablePlatformList(seed).c_str());
- }
- AZ_Printf(AppWindowName, "\n");
- }
- bool ApplicationManager::RunPlatformSpecificAssetListCommands(const AssetListsParams& params, AzFramework::PlatformFlags platformFlags)
- {
- using namespace AzToolsFramework;
- auto platformIds = AzFramework::PlatformHelper::GetPlatformIndices(platformFlags);
- auto platformIdsInterpreted = AzFramework::PlatformHelper::GetPlatformIndicesInterpreted(platformFlags);
- // Add Seeds
- for (const auto& platformId : platformIds)
- {
- AzFramework::PlatformFlags platformFlag = AzFramework::PlatformHelper::GetPlatformFlagFromPlatformIndex(platformId);
- for (const AZStd::string& assetPath : params.m_addSeedList)
- {
- m_assetSeedManager->AddSeedAsset(assetPath, platformFlag);
- }
- }
- AZStd::unordered_set<AZ::Data::AssetId> exclusionList;
- AZStd::vector<AZStd::string> wildcardPatternExclusionList;
- for (const AZStd::string& asset : params.m_skipList)
- {
- // Is input a wildcard pattern?
- if (LooksLikeWildcardPattern(asset))
- {
- wildcardPatternExclusionList.emplace_back(asset);
- continue;
- }
- // Is input a valid asset in the cache?
- AZ::Data::AssetId assetId = m_assetSeedManager->GetAssetIdByPath(asset, platformFlags);
- if (assetId.IsValid())
- {
- exclusionList.emplace(assetId);
- }
- }
- // Print
- bool printExistingFiles = false;
- if (params.m_print)
- {
- printExistingFiles = !params.m_assetListFile.AbsolutePath().empty()
- && params.m_seedListFiles.empty()
- && params.m_addSeedList.empty()
- && !params.m_addDefaultSeedListFiles;
- PrintAssetLists(params, platformIdsInterpreted, printExistingFiles, exclusionList, wildcardPatternExclusionList);
- }
- // Dry Run
- if (params.m_dryRun || params.m_assetListFile.AbsolutePath().empty() || printExistingFiles)
- {
- return true;
- }
- AZ_Printf(AssetBundler::AppWindowName, "\n");
- AZStd::atomic_uint failureCount = 0;
- // Save
- AZ::parallel_for_each(platformIdsInterpreted.begin(), platformIdsInterpreted.end(), [this, ¶ms, &failureCount, &exclusionList, &wildcardPatternExclusionList](AzFramework::PlatformId platformId)
- {
- AzFramework::PlatformFlags platformFlag = AzFramework::PlatformHelper::GetPlatformFlagFromPlatformIndex(platformId);
- FilePath platformSpecificAssetListFilePath = FilePath(params.m_assetListFile.AbsolutePath(), AzFramework::PlatformHelper::GetPlatformName(platformId));
- AZStd::string assetListFileAbsolutePath = platformSpecificAssetListFilePath.AbsolutePath();
- AZ_TracePrintf(AssetBundler::AppWindowName, "Saving Asset List file to ( %s )...\n", assetListFileAbsolutePath.c_str());
- // Check if we are performing a destructive overwrite that the user did not approve
- if (!params.m_allowOverwrites && AZ::IO::FileIOBase::GetInstance()->Exists(assetListFileAbsolutePath.c_str()))
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Asset List file ( %s ) already exists, running this command would perform a destructive overwrite.\n\n"
- "Run your command again with the ( --%s ) arg if you want to save over the existing file.\n", assetListFileAbsolutePath.c_str(), AllowOverwritesFlag);
- failureCount.fetch_add(1, AZStd::memory_order::memory_order_relaxed);
- return;
- }
- // Generate Debug file
- AZStd::string debugListFileAbsolutePath;
- if (params.m_generateDebugFile)
- {
- debugListFileAbsolutePath = assetListFileAbsolutePath;
- AZ::StringFunc::Path::ReplaceExtension(debugListFileAbsolutePath, AssetFileDebugInfoList::GetAssetListDebugFileExtension());
- AZ_TracePrintf(AssetBundler::AppWindowName, "Saving Asset List Debug file to ( %s )...\n", debugListFileAbsolutePath.c_str());
- }
- if (!m_assetSeedManager->SaveAssetFileInfo(assetListFileAbsolutePath, platformFlag, exclusionList, debugListFileAbsolutePath, wildcardPatternExclusionList))
- {
- AZ_Error(AssetBundler::AppWindowName, false, "Unable to save Asset List file to ( %s ).\n", assetListFileAbsolutePath.c_str());
- failureCount.fetch_add(1, AZStd::memory_order::memory_order_relaxed);
- return;
- }
- AZ_TracePrintf(AssetBundler::AppWindowName, "Save successful! ( %s )\n", assetListFileAbsolutePath.c_str());
- });
- return failureCount == 0;
- }
- void ApplicationManager::PrintAssetLists(const AssetListsParams& params, const AZStd::fixed_vector<AzFramework::PlatformId, AzFramework::PlatformId::NumPlatformIds>& platformIds,
- bool printExistingFiles, const AZStd::unordered_set<AZ::Data::AssetId>& exclusionList, const AZStd::vector<AZStd::string>& wildcardPatternExclusionList)
- {
- using namespace AzToolsFramework;
- // The user wants to print the contents of a pre-existing Asset List file *without* modifying it
- if (printExistingFiles)
- {
- AZStd::vector<FilePath> allAssetListFiles = GetAllPlatformSpecificFilesOnDisk(params.m_assetListFile, params.m_platformFlags);
- for (const FilePath& assetListFilePath : allAssetListFiles)
- {
- auto assetFileInfoOutcome = m_assetSeedManager->LoadAssetFileInfo(assetListFilePath.AbsolutePath());
- if (!assetFileInfoOutcome.IsSuccess())
- {
- AZ_Error(AssetBundler::AppWindowName, false, assetFileInfoOutcome.GetError().c_str());
- }
- AZ_Printf(AssetBundler::AppWindowName, "\nPrinting contents of ( %s ):\n", assetListFilePath.AbsolutePath().c_str());
- for (const AssetFileInfo& assetFileInfo : assetFileInfoOutcome.GetValue().m_fileInfoList)
- {
- AZ_Printf(AssetBundler::AppWindowName, "- %s\n", assetFileInfo.m_assetRelativePath.c_str());
- }
- AZ_Printf(AssetBundler::AppWindowName, "Total number of assets in ( %s ): %d\n", assetListFilePath.AbsolutePath().c_str(), assetFileInfoOutcome.GetValue().m_fileInfoList.size());
- }
- return;
- }
- // The user wants to print the contents of a recently-modified Asset List file
- for (const AzFramework::PlatformId platformId : platformIds)
- {
- AssetSeedManager::AssetsInfoList assetsInfoList = m_assetSeedManager->GetDependenciesInfo(platformId, exclusionList, nullptr, wildcardPatternExclusionList);
- AZ_Printf(AssetBundler::AppWindowName, "\nPrinting assets for Platform ( %s ):\n", AzFramework::PlatformHelper::GetPlatformName(platformId));
- for (const AZ::Data::AssetInfo& assetInfo : assetsInfoList)
- {
- AZ_Printf(AssetBundler::AppWindowName, "- %s\n", assetInfo.m_relativePath.c_str());
- }
- AZ_Printf(AssetBundler::AppWindowName, "Total number of assets for Platform ( %s ): %d.\n", AzFramework::PlatformHelper::GetPlatformName(platformId), assetsInfoList.size());
- }
- }
- AZStd::vector<FilePath> ApplicationManager::GetAllPlatformSpecificFilesOnDisk(const FilePath& platformIndependentFilePath, AzFramework::PlatformFlags platformFlags)
- {
- using namespace AzToolsFramework;
- AZStd::vector<FilePath> platformSpecificPaths;
- if (platformIndependentFilePath.AbsolutePath().empty())
- {
- return platformSpecificPaths;
- }
- FilePath testFilePath;
- for (AZStd::string_view platformName : AzFramework::PlatformHelper::GetPlatformsInterpreted(platformFlags))
- {
- testFilePath = FilePath(platformIndependentFilePath.AbsolutePath(), platformName);
- if (!testFilePath.AbsolutePath().empty() && AZ::IO::FileIOBase::GetInstance()->Exists(testFilePath.AbsolutePath().c_str()))
- {
- platformSpecificPaths.emplace_back(testFilePath.AbsolutePath());
- }
- }
- return platformSpecificPaths;
- }
- AZ::Outcome<void, AZStd::string> ApplicationManager::ApplyBundleSettingsOverrides(
- AzToolsFramework::AssetBundleSettings& bundleSettings,
- const AZStd::string& assetListFilePath,
- const AZStd::string& outputBundleFilePath,
- int bundleVersion,
- int maxBundleSize)
- {
- using namespace AzToolsFramework;
- // Asset List file path
- if (!assetListFilePath.empty())
- {
- FilePath platformSpecificPath = FilePath(assetListFilePath, bundleSettings.m_platform);
- if (platformSpecificPath.AbsolutePath().empty())
- {
- return AZ::Failure(AZStd::string::format(
- "Failed to apply Bundle Settings overrides: ( %s ) is incompatible with input Bundle Settings file.",
- assetListFilePath.c_str()));
- }
- bundleSettings.m_assetFileInfoListPath = platformSpecificPath.AbsolutePath();
- }
- // Output Bundle file path
- if (!outputBundleFilePath.empty())
- {
- FilePath platformSpecificPath = FilePath(outputBundleFilePath, bundleSettings.m_platform);
- if (platformSpecificPath.AbsolutePath().empty())
- {
- return AZ::Failure(AZStd::string::format(
- "Failed to apply Bundle Settings overrides: ( %s ) is incompatible with input Bundle Settings file.",
- outputBundleFilePath.c_str()));
- }
- bundleSettings.m_bundleFilePath = platformSpecificPath.AbsolutePath();
- }
- // Bundle Version
- if (bundleVersion > 0 && bundleVersion <= AzFramework::AssetBundleManifest::CurrentBundleVersion)
- {
- bundleSettings.m_bundleVersion = bundleVersion;
- }
- // Max Bundle Size
- if (maxBundleSize > 0 && maxBundleSize <= AssetBundleSettings::GetMaxBundleSizeInMB())
- {
- bundleSettings.m_maxBundleSizeInMB = maxBundleSize;
- }
- return AZ::Success();
- }
- ////////////////////////////////////////////////////////////////////////////////////////////
- // Output Help Text
- ////////////////////////////////////////////////////////////////////////////////////////////
- void ApplicationManager::OutputHelp(CommandType commandType)
- {
- using namespace AssetBundler;
- AZ_Printf(AppWindowName, "This program can be used to create asset bundles that can be used by the runtime to load assets.\n");
- AZ_Printf(AppWindowName, "--%-20s-Displays more detailed output messages.\n\n", VerboseFlag);
- switch (commandType)
- {
- case CommandType::Seeds:
- OutputHelpSeeds();
- break;
- case CommandType::AssetLists:
- OutputHelpAssetLists();
- break;
- case CommandType::ComparisonRules:
- OutputHelpComparisonRules();
- break;
- case CommandType::Compare:
- OutputHelpCompare();
- break;
- case CommandType::BundleSettings:
- OutputHelpBundleSettings();
- break;
- case CommandType::Bundles:
- OutputHelpBundles();
- break;
- case CommandType::BundleSeed:
- OutputHelpBundleSeed();
- break;
- case CommandType::Invalid:
- AZ_Printf(AppWindowName, "Input to this command follows the format: [subCommandName] --exampleArgThatTakesInput exampleInput --exampleFlagThatTakesNoInput\n");
- AZ_Printf(AppWindowName, " - Example: \"assetLists --assetListFile example.assetlist --addDefaultSeedListFiles --print\"\n");
- AZ_Printf(AppWindowName, "\n");
- AZ_Printf(AppWindowName, "Some args in this tool take paths as arguments, and there are two main types:\n");
- AZ_Printf(AppWindowName, " \"path\" - This refers to an Engine-Root-Relative path.\n");
- AZ_Printf(AppWindowName, " - Example: \"C:\\O3DE\\dev\\SamplesProject\\test.txt\" can be represented as \"SamplesProject\\test.txt\".\n");
- AZ_Printf(AppWindowName, " \"cache path\" - This refers to a Cache-Relative path.\n");
- AZ_Printf(AppWindowName, " - Example: \"C:\\O3DE\\dev\\Cache\\SamplesProject\\pc\\samplesproject\\animations\\skeletonlist.xml\" is represented as \"animations\\skeletonlist.xml\".\n");
- AZ_Printf(AppWindowName, "\n");
- OutputHelpSeeds();
- OutputHelpAssetLists();
- OutputHelpComparisonRules();
- OutputHelpCompare();
- OutputHelpBundleSettings();
- OutputHelpBundles();
- OutputHelpBundleSeed();
- AZ_Printf(AppWindowName, "\n\nTo see less Help text, type in a Sub-Command before requesting the Help text. For example: \"%s --%s\".\n", SeedsCommand, HelpFlag);
- break;
- }
- if (commandType != CommandType::Invalid)
- {
- AZ_Printf(AppWindowName, "\n\nTo see more Help text, type: \"--%s\" without any other input.\n", HelpFlag);
- }
- }
- void ApplicationManager::OutputHelpSeeds()
- {
- using namespace AzToolsFramework;
- AZ_Printf(AppWindowName, "\n%-25s-Subcommand for performing operations on Seed List files.\n", SeedsCommand);
- AZ_Printf(AppWindowName, " --%-25s-[Required] Specifies the Seed List file to operate on by path. Must include (.%s) file extension.\n", SeedListFileArg, AssetSeedManager::GetSeedFileExtension());
- AZ_Printf(AppWindowName, " --%-25s-Adds the asset to the list of root assets for the specified platform.\n", AddSeedArg);
- AZ_Printf(AppWindowName, "%-31s---Takes in a cache path to a pre-processed asset.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Removes the asset from the list of root assets for the specified platform.\n", RemoveSeedArg);
- AZ_Printf(AppWindowName, "%-31s---To completely remove the asset, it must be removed for all platforms.\n", "");
- AZ_Printf(AppWindowName, "%-31s---Takes in a cache path to a pre-processed asset. A cache path is a path relative to \"ProjectPath\\Cache\\platform\\\"\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Adds the specified platform to every Seed in the Seed List file, if possible.\n", AddPlatformToAllSeedsFlag);
- AZ_Printf(AppWindowName, " --%-25s-Removes the specified platform from every Seed in the Seed List file, if possible.\n", RemovePlatformFromAllSeedsFlag);
- AZ_Printf(AppWindowName, " --%-25s-Outputs the contents of the Seed List file after performing any specified operations.\n", PrintFlag);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the platform(s) referenced by all Seed operations.\n", PlatformArg);
- AZ_Printf(AppWindowName, "%-31s---Requires an existing cache of assets for the input platform(s).\n", "");
- AZ_Printf(AppWindowName, "%-31s---Defaults to all enabled platforms. Platforms can be changed by modifying AssetProcessorPlatformConfig.setreg.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Updates the path hints stored in the Seed List file.\n", UpdateSeedPathArg);
- AZ_Printf(AppWindowName, " --%-25s-Removes the path hints stored in the Seed List file.\n", RemoveSeedPathArg);
- AZ_Printf(AppWindowName, " --%-25s-Allows input file path to still match if the file path case is different than on disk.\n", IgnoreFileCaseFlag);
- AZ_Printf(AppWindowName, " --%-25s-[Testing] Specifies the Asset Catalog file referenced by all Seed operations.\n", AssetCatalogFileArg);
- AZ_Printf(AppWindowName, "%-31s---Designed to be used in Unit Tests.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Specifies the game project to use rather than the current default project set in bootstrap.cfg's project_path.\n", ProjectArg);
- }
- void ApplicationManager::OutputHelpAssetLists()
- {
- using namespace AzToolsFramework;
- AZ_Printf(AppWindowName, "\n%-25s-Subcommand for generating Asset List Files.\n", AssetListsCommand);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the Asset List file to operate on by path. Must include (.%s) file extension.\n", AssetListFileArg, AssetSeedManager::GetAssetListFileExtension());
- AZ_Printf(AppWindowName, " --%-25s-Specifies the Seed List file(s) that will be used as root(s) when generating this Asset List file.\n", SeedListFileArg);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the Seed(s) to use as root(s) when generating this Asset List File.\n", AddSeedArg);
- AZ_Printf(AppWindowName, "%-31s---Takes in a cache path to a pre-processed asset. A cache path is a path relative to \"ProjectPath\\Cache\\platform\\\"\n", "");
- AZ_Printf(AppWindowName, " --%-25s-The specified files and all dependencies will be ignored when generating the Asset List file.\n", SkipArg);
- AZ_Printf(AppWindowName, "%-31s---Takes in a comma-separated list of either: cache paths to pre-processed assets, or wildcard patterns.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Automatically include all default Seed List files in generated Asset List File.\n", AddDefaultSeedListFilesFlag);
- AZ_Printf(AppWindowName, "%-31s---This will include Seed List files for the Open 3D Engine Engine and all enabled Gems.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Specifies the platform(s) to generate an Asset List file for.\n", PlatformArg);
- AZ_Printf(AppWindowName, "%-31s---Requires an existing cache of assets for the input platform(s).\n", "");
- AZ_Printf(AppWindowName, "%-31s---Defaults to all enabled platforms. Platforms can be changed by modifying AssetProcessorPlatformConfig.setreg.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-[Testing] Specifies the Asset Catalog file referenced by all Asset List operations.\n", AssetCatalogFileArg);
- AZ_Printf(AppWindowName, "%-31s---Designed to be used in Unit Tests.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Outputs the contents of the Asset List file after adding any specified seed files.\n", PrintFlag);
- AZ_Printf(AppWindowName, " --%-25s-Run all input commands, without saving to the specified Asset List file.\n", DryRunFlag);
- AZ_Printf(AppWindowName, " --%-25s-Generates a human-readable file that maps every entry in the Asset List file to the Seed that generated it.\n", GenerateDebugFileFlag);
- AZ_Printf(AppWindowName, " --%-25s-Allow destructive overwrites of files. Include this arg in automation.\n", AllowOverwritesFlag);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the game project to use rather than the current default project set in bootstrap.cfg's project_path.\n", ProjectArg);
- }
- void ApplicationManager::OutputHelpComparisonRules()
- {
- using namespace AzToolsFramework;
- AZ_Printf(AppWindowName, "\n%-25s-Subcommand for generating Comparison Rules files.\n", ComparisonRulesCommand);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the Comparison Rules file to operate on by path.\n", ComparisonRulesFileArg);
- AZ_Printf(AppWindowName, " --%-25s-Adds a Comparison Step to the given Comparison Rules file at the specified line number.\n", AddComparisonStepArg);
- AZ_Printf(AppWindowName, "%-31s---Takes in a non-negative integer. If no input is supplied, the Comparison Step will be added to the end.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Removes the Comparison Step present at the input line number from the given Comparison Rules file.\n", RemoveComparisonStepArg);
- AZ_Printf(AppWindowName, " --%-25s-Moves a Comparison Step from one line number to another line number in the given Comparison Rules file.\n", MoveComparisonStepArg);
- AZ_Printf(AppWindowName, "%-31s---Takes in a comma-separated pair of non-negative integers: the original line number and the destination line number.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Edits the Comparison Step at the input line number using values from other input arguments.\n", EditComparisonStepArg);
- AZ_Printf(AppWindowName, "%-31s---When editing, other input arguments may only contain one input value.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of Comparison types.\n", ComparisonTypeArg);
- AZ_Printf(AppWindowName, "%-31s---Valid inputs: delta, union, intersection, complement, filepattern.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of file pattern matching types.\n", ComparisonFilePatternTypeArg);
- AZ_Printf(AppWindowName, "%-31s---Valid inputs: wildcard, regex.\n", "");
- AZ_Printf(AppWindowName, "%-31s---Must match the number of FilePattern comparisons specified in ( --%s ) argument list.\n", "", ComparisonTypeArg);
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of file patterns.\n", ComparisonFilePatternArg);
- AZ_Printf(AppWindowName, "%-31s---Must match the number of FilePattern comparisons specified in ( --%s ) argument list.\n", "", ComparisonTypeArg);
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of output Token names.\n", ComparisonTokenNameArg);
- AZ_Printf(AppWindowName, " --%-25s-The Token name of the Comparison Step you wish to use as the first input of this Comparison Step.\n", ComparisonFirstInputArg);
- AZ_Printf(AppWindowName, " --%-25s-The Token name of the Comparison Step you wish to use as the second input of this Comparison Step.\n", ComparisonSecondInputArg);
- AZ_Printf(AppWindowName, "%-31s---Comparison Steps of the ( FilePattern ) type only accept one input Token, and cannot be used with this arg.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Outputs the contents of the Comparison Rules file after performing any specified operations.\n", PrintFlag);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the game project to use rather than the current default project set in bootstrap.cfg's project_path.\n", ProjectArg);
- }
- void ApplicationManager::OutputHelpCompare()
- {
- using namespace AzToolsFramework;
- AZ_Printf(AppWindowName, "\n%-25s-Subcommand for performing comparisons between asset list files.\n", CompareCommand);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the Comparison Rules file to load rules from.\n", ComparisonRulesFileArg);
- AZ_Printf(AppWindowName, "%-31s---When entering input and output values, input the single '$' character to use the default values defined in the file.\n", "");
- AZ_Printf(AppWindowName, "%-31s---All additional comparison rules specified in this command will be done after the comparison operations loaded from the rules file.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of comparison types.\n", ComparisonTypeArg);
- AZ_Printf(AppWindowName, "%-31s---Valid inputs: delta, union, intersection, complement, filepattern, intersectioncount.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of file pattern matching types.\n", ComparisonFilePatternTypeArg);
- AZ_Printf(AppWindowName, "%-31s---Valid inputs: wildcard, regex.\n", "");
- AZ_Printf(AppWindowName, "%-31s---Must match the number of FilePattern comparisons specified in ( --%s ) argument list.\n", "", ComparisonTypeArg);
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of file patterns.\n", ComparisonFilePatternArg);
- AZ_Printf(AppWindowName, "%-31s---Must match the number of FilePattern comparisons specified in ( --%s ) argument list.\n", "", ComparisonTypeArg);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the count that will be used during the %s compare operation.\n", IntersectionCountArg, AssetFileInfoListComparison::ComparisonTypeNames[aznumeric_cast<AZ::u8>(AssetFileInfoListComparison::ComparisonType::IntersectionCount)]);
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of first inputs for comparison.\n", CompareFirstFileArg);
- AZ_Printf(AppWindowName, "%-31s---Must match the number of comparison operations.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of second inputs for comparison.\n", CompareSecondFileArg);
- AZ_Printf(AppWindowName, "%-31s---Must match the number of comparison operations that require two inputs.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of outputs for the comparison command.\n", CompareOutputFileArg);
- AZ_Printf(AppWindowName, "%-31s---Must match the number of comparison operations.\n", "");
- AZ_Printf(AppWindowName, "%-31s---Inputs and outputs can be a file or a variable passed from another comparison.\n", "");
- AZ_Printf(AppWindowName, "%-31s---Variables are specified by the prefix %c.\n", "", compareVariablePrefix);
- AZ_Printf(AppWindowName, " --%-25s-A comma seperated list of paths or variables to print to console after comparison operations complete.\n", ComparePrintArg);
- AZ_Printf(AppWindowName, "%-31s---Leave list blank to just print the final comparison result.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Specifies the platform(s) referenced when determining which Asset List files to compare.\n", PlatformArg);
- AZ_Printf(AppWindowName, "%-31s---All input Asset List files must exist for all specified platforms\n", "");
- AZ_Printf(AppWindowName, "%-31s---Defaults to all enabled platforms. Platforms can be changed by modifying AssetProcessorPlatformConfig.setreg.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Allow destructive overwrites of files. Include this arg in automation.\n", AllowOverwritesFlag);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the game project to use rather than the current default project set in bootstrap.cfg's project_path.\n", ProjectArg);
- }
- void ApplicationManager::OutputHelpBundleSettings()
- {
- using namespace AzToolsFramework;
- AZ_Printf(AppWindowName, "\n%-25s-Subcommand for performing operations on Bundle Settings files.\n", BundleSettingsCommand);
- AZ_Printf(AppWindowName, " --%-25s-[Required] Specifies the Bundle Settings file to operate on by path. Must include (.%s) file extension.\n", BundleSettingsFileArg, AssetBundleSettings::GetBundleSettingsFileExtension());
- AZ_Printf(AppWindowName, " --%-25s-Sets the Asset List file to use for Bundle generation. Must include (.%s) file extension.\n", AssetListFileArg, AssetSeedManager::GetAssetListFileExtension());
- AZ_Printf(AppWindowName, " --%-25s-Sets the path where generated Bundles will be stored. Must include (.%s) file extension.\n", OutputBundlePathArg, AssetBundleSettings::GetBundleFileExtension());
- AZ_Printf(AppWindowName, " --%-25s-Determines which version of Open 3D Engine Bundles to generate. Current version is (%i).\n", BundleVersionArg, AzFramework::AssetBundleManifest::CurrentBundleVersion);
- AZ_Printf(AppWindowName, " --%-25s-Sets the maximum size for a single Bundle (in MB). Default size is (%i MB).\n", MaxBundleSizeArg, AssetBundleSettings::GetMaxBundleSizeInMB());
- AZ_Printf(AppWindowName, "%-31s---Bundles larger than this limit will be divided into a series of smaller Bundles and named accordingly.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Specifies the platform(s) referenced by all Bundle Settings operations.\n", PlatformArg);
- AZ_Printf(AppWindowName, "%-31s---Defaults to all enabled platforms. Platforms can be changed by modifying AssetProcessorPlatformConfig.setreg.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Outputs the contents of the Bundle Settings file after modifying any specified values.\n", PrintFlag);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the game project to use rather than the current default project set in bootstrap.cfg's project_path.\n", ProjectArg);
- }
- void ApplicationManager::OutputHelpBundles()
- {
- using namespace AzToolsFramework;
- AZ_Printf(AppWindowName, "\n%-25s-Subcommand for generating bundles. Must provide either (--%s) or (--%s and --%s).\n", BundlesCommand, BundleSettingsFileArg, AssetListFileArg, OutputBundlePathArg);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the Bundle Settings files to operate on by path. Must include (.%s) file extension.\n", BundleSettingsFileArg, AssetBundleSettings::GetBundleSettingsFileExtension());
- AZ_Printf(AppWindowName, "%-31s---If any other args are specified, they will override the values stored inside this file.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Sets the Asset List files to use for Bundle generation. Must include (.%s) file extension.\n", AssetListFileArg, AssetSeedManager::GetAssetListFileExtension());
- AZ_Printf(AppWindowName, " --%-25s-Sets the paths where generated Bundles will be stored. Must include (.%s) file extension.\n", OutputBundlePathArg, AssetBundleSettings::GetBundleFileExtension());
- AZ_Printf(AppWindowName, " --%-25s-Determines which versions of Open 3D Engine Bundles to generate. Current version is (%i).\n", BundleVersionArg, AzFramework::AssetBundleManifest::CurrentBundleVersion);
- AZ_Printf(AppWindowName, " --%-25s-Sets the maximum size for Bundles (in MB). Default size is (%i MB).\n", MaxBundleSizeArg, AssetBundleSettings::GetMaxBundleSizeInMB());
- AZ_Printf(AppWindowName, "%-31s---Bundles larger than this limit will be divided into a series of smaller Bundles and named accordingly.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Specifies the platform(s) that will be referenced when generating Bundles.\n", PlatformArg);
- AZ_Printf(AppWindowName, "%-31s---If no platforms are specified, Bundles will be generated for all available platforms.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Allow destructive overwrites of files. Include this arg in automation.\n", AllowOverwritesFlag);
- AZ_Printf(AppWindowName, " --%-25s-Specifies the game project to use rather than the current default project set in bootstrap.cfg's project_path.\n", ProjectArg);
- }
- void ApplicationManager::OutputHelpBundleSeed()
- {
- using namespace AzToolsFramework;
- AZ_Printf(AppWindowName, "\n%-25s-Subcommand for generating bundles directly from seeds. Must provide either (--%s) or (--%s).\n", BundleSeedCommand, BundleSettingsFileArg, OutputBundlePathArg);
- AZ_Printf(AppWindowName, " --%-25s-Adds the asset to the list of root assets for the specified platform.\n", AddSeedArg);
- AZ_Printf(AppWindowName, "%-31s---Takes in a cache path to a pre-processed asset. A cache path is a path relative to \"ProjectPath\\Cache\\platform\\\"\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Specifies the Bundle Settings file to operate on by path. Must include (.%s) file extension.\n", BundleSettingsFileArg, AssetBundleSettings::GetBundleSettingsFileExtension());
- AZ_Printf(AppWindowName, " --%-25s-Sets the path where generated Bundles will be stored. Must include (.%s) file extension.\n", OutputBundlePathArg, AssetBundleSettings::GetBundleFileExtension());
- AZ_Printf(AppWindowName, " --%-25s-Determines which version of Open 3D Engine Bundles to generate. Current version is (%i).\n", BundleVersionArg, AzFramework::AssetBundleManifest::CurrentBundleVersion);
- AZ_Printf(AppWindowName, " --%-25s-Sets the maximum size for a single Bundle (in MB). Default size is (%i MB).\n", MaxBundleSizeArg, AssetBundleSettings::GetMaxBundleSizeInMB());
- AZ_Printf(AppWindowName, "%-31s---Bundles larger than this limit will be divided into a series of smaller Bundles and named accordingly.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Specifies the platform(s) that will be referenced when generating Bundles.\n", PlatformArg);
- AZ_Printf(AppWindowName, "%-31s---If no platforms are specified, Bundles will be generated for all available platforms.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Allow destructive overwrites of files. Include this arg in automation.\n", AllowOverwritesFlag);
- AZ_Printf(AppWindowName, " --%-25s-[Testing] Specifies the Asset Catalog file referenced by all Bundle operations.\n", AssetCatalogFileArg);
- AZ_Printf(AppWindowName, "%-31s---Designed to be used in Unit Tests.\n", "");
- AZ_Printf(AppWindowName, " --%-25s-Specifies the game project to use rather than the current default project set in bootstrap.cfg's project_path.\n", ProjectArg);
- }
- ////////////////////////////////////////////////////////////////////////////////////////////
- // Formatting for Output Text
- ////////////////////////////////////////////////////////////////////////////////////////////
- bool ApplicationManager::OnPreError(const char* window, const char* fileName, int line, [[maybe_unused]] const char* func, const char* message)
- {
- printf("\n");
- printf("[ERROR] - %s:\n", window);
- if (m_showVerboseOutput)
- {
- printf("(%s - Line %i)\n", fileName, line);
- }
- printf("%s", message);
- printf("\n");
- return true;
- }
- bool ApplicationManager::OnPreWarning(const char* window, const char* fileName, int line, [[maybe_unused]] const char* func, const char* message)
- {
- printf("\n");
- printf("[WARN] - %s:\n", window);
- if (m_showVerboseOutput)
- {
- printf("(%s - Line %i)\n", fileName, line);
- }
- printf("%s", message);
- printf("\n");
- return true;
- }
- bool ApplicationManager::OnPrintf(const char* window, const char* message)
- {
- if (window == AssetBundler::AppWindowName || (m_showVerboseOutput && window == AssetBundler::AppWindowNameVerbose))
- {
- printf("%s", message);
- return true;
- }
- return !m_showVerboseOutput;
- }
- } // namespace AssetBundler
- #include <source/utils/moc_applicationManager.cpp>
|