Testing in this area focuses on the functionality of:
- Asset Bundler
- Asset Bundler Batch
- Asset Bundler GUI
- Asset List Comparison Operations
- Default Seedlists
- Missing Dependency Scanner
- Asset Validation Gem
- SeedMode
- Bundle Mode
- File Tagging System
Test guidance will sometimes note specific issues to watch for. The common issues below should be watched for through all testing, even if unrelated to the current workflow being tested.
- Console log errors/warnings/spam
- Asserts
- Improperly rendered scenes
- Creating a Project Game Release Layout
- Asset Bundling Concepts and Terms
- O3DE Editor
- Console
- Asset Cache
Project Requirements: Any project with Asset Validation gem and multiple platforms enabled.
Resources:
Validating Seedpaths and Seedlists
Validating Bundled Assets
Note: You will need to enter game mode for Seedmode and BundleMode to report missing assets.
Product: Seedlists with all assets ready for packaging.
Suggested Time Box: 30 Minutes
| Workflow | Requests | Things to Watch For |
|---|---|---|
| Launch the Editor and load a level. | - Create a new level - Load an existing level |
- There should be no console errors - There should be no Asset Validation warings when neither seed mode nor bundle mode are enabled |
| Enable Seed mode and enter game mode. | - Have no assets in the level - Have default assets in the level - Have custom assets in the level - Add new assets |
- There should be no assets reported missing when no assets are loaded - Assets should be reported as missing when default or custom assets are preset - Excluded assets, such as shaders, should not be reported as missing |
| Add seedpath. | - Add seedpath for level - Add seedpath for individual assets present in level - Add seedpath for assets not currently present in the level |
- Added assets and their dependencies should not report as missing - Added seedpaths not present in level should not report as missing |
| Remove a seedpath. | - Remove seedpath for default assets - Remove seedpath for custom assets - Remove seedpath for asset not present in level |
- Removed seedpath of asset not present in level should not report as missing - Removed seedpath of asset present in level should report as missing |
| Create a seedlist. | - Include assets from the previous seedpath | |
| Add a seedlist. | - Added seedlist assets present in level should no longer report as missing - Added seedlist assets not present in the level should not report as missing |
|
| Remove a seedlist. | - Removed seedlist assets present in level should report as missing - Removed seedlist of asset present in level should report as missing |
Product: Successfully create bundles from an assetlist and validate missing assets in a level.
Suggested Time Box: 90 Minutes
| Workflow | Requests | Things to Watch For |
|---|---|---|
| Generate a new seedlist and add/edit assets in the seedlist. | - Saved to it's default directory - Saved to a different directory - Populated with assets from different platforms |
- Should successfully create seedlist - Should successfully add assets to seedlist - Should successfully save after adding/removing assets to/from existing seedlist - Should not report console errors - Should not have duplicate seedlist entries in GUI |
| Generate an assetlist from a seedlist file. | - Created from one or more seedlist files - Created from Default Seedlists - Created for different platforms |
- Should successfully create assetlist - Should successfully populate assetlist with asset dependencies - Should not report console errors - Should be able to override existing assetlists (requires confirmation in batch) - Should not have duplicate assetlist entries in GUI |
| Generate a rule and add steps. | - Add a single step - Add Multiple steps |
- Should successfully create rule - Should successfully update rule with saved steps - Should successfully populate information when adding a seedlist - Should not report console errors - GUI successfully updates |
| Run a rule to generate an assetlist. | - Run on multiple platforms simultaneously - Saved to it's default directory - Saved to a different directory |
- Rule's operation should successfully apply to assetlist - Should successfully create assetlist - Should successfully populate assetlist with asset dependencies - Should not report console errors - Should be able to override existing assetlists (requires confirmation in batch) - Should not have duplicate assetlist entries in GUI |
| Generate a bundle from an assetlist. | - Generate bundles for different platforms | - Bundle should successfully generate - Should not report console errors |
| Verify bundle creation in "Completed Bundles" tab. | - GUI should successfully update - Should not report console errors - Bundle information should displayed correctly |
|
| Launch Editor, create a level, and add assets. | - Use assets included in the generated bundles - Use assets not included in the generated bundles |
|
| Enable Bundle Mode, Load Bundles, and Enter Game Mode. | - Enable Bundle Mode in Log, Warning, or Error Mode - Load bundles after enabling Bundle Mode - Use addseedpath and listknown asset commands |
- Should report console errors - Missing from bundle text correctly displays assets in the level missing from mounted bundles - Listknown command displays assets and dependencies from added seedpath - Missing files are displayed in the console after entering/exiting Game Mode |
| Add missing assets to a seedlist and proceed through the flow of generating a bundle. | - Create a new seedlist - Update an existing seedlist |
- Should successfully create seedlist/assetlist/bundle - Should successfully add assets to seedlist/assetlist/bundle - Should successfully save after adding assets to existing seedlist/assetlist/bundle - Should not report console errors - Should not have duplicate seedlist/assetlist/bundle entries in GUI |
| Reload Bundles and Verify Missing Assets. | - Should report console errors - Missing from bundle text correctly displays assets in the level missing from mounted bundles - Assets added via the new bundle should no longer reported as "missing" - Missing files are displayed in the console after entering/exiting Game Mode |