517 lines
		
	
	
		
			13 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			517 lines
		
	
	
		
			13 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| # Changelog
 | |
| 
 | |
| ## [3.1.0] - 2025-03-28
 | |
| ### Added
 | |
| - Added an optional command-line argument "perfTestResults" to control the target location of performance test run results file.
 | |
| ### Fixed
 | |
| - Warmup cycles no longer record GC measurements.
 | |
| - Setup and Cleanup cycles no longer contribute to GC measurements.
 | |
| 
 | |
| ## [3.0.3] - 2023-09-11
 | |
| ### Fixed 
 | |
| - Fixed issue where exception in OnTestEnded callback would result in EndTest method not finalising properly
 | |
| ### Changed
 | |
| - Temporarily removed "Open Script" from Performance Benchmark Window
 | |
| - Some clarifications in documentation were added ("Extension" naming changed to "Package", Package limitations clarified)
 | |
| 
 | |
| ## [3.0.2] - 2023-06-29
 | |
| ### Changed
 | |
| - Added additional InternalsVisibleTo attribute for internal test assembly
 | |
| 
 | |
| ## [3.0.1] - 2023-06-23
 | |
| ### Changed
 | |
| - Removed false "unityRelease" field from package.json
 | |
| 
 | |
| ## [3.0.0] - 2023-06-05
 | |
| ### Added
 | |
| - "Open Source Code" menu item to test results
 | |
| - Test Filter to filter results by test name
 | |
| ### Changed
 | |
| - Items in test results are grouped by classname
 | |
| - Make Sample Groups to be shown only when clicking on items with them 
 | |
| - "New Data available" label re-located 
 | |
| - Replaced CamelCase headers with regular text headers in csv report
 | |
| - Replaced TRUE/FALSE with Yes/No in the "Increase Is Better" column in csv report
 | |
| - Renamed the default report name to PerformanceTestResults
 | |
| - Documentation updates to reflect API changes
 | |
| ### Fixed
 | |
| - Median calculation in case of even number of samples 
 | |
| - Deviation division by zero
 | |
| - Exception thrown after clicking Cancel button (during Test Result export)
 | |
| - The issue where the last column was always empty in csv report
 | |
| 
 | |
| ## [3.0.0-pre.2] - 2023-04-06
 | |
| ### Added
 | |
| - Help button, which redirects the user to documentation website
 | |
| - Clear Results button, which clears all Performance test results
 | |
| - Updated CI to support more Unity versions and expand test coverage
 | |
| ### Changed
 | |
| - Updated the style of toolbar buttons to match that of the Test Runner window for consistency
 | |
| - Export button is now disabled instead of hidden when there are no Performance test results
 | |
| - Made AutoRefresh toggle retain its state after closing and reopening the window
 | |
| - Moved the Performance Test Report from 'Window/Analysis' to 'Window/General' near Test Runner for better accessibility
 | |
| ### Removed
 | |
| - Build project from CI
 | |
| ### Fixed
 | |
| - Issue where running tests with the Test Report window open would cause the error message "The object of type 'Material' has been destroyed" to appear
 | |
| - Issues where incorrect labels were displayed at certain scenarios
 | |
| - Issues flagged by SonarQube
 | |
| 
 | |
| ## [3.0.0-pre.1] - 2023-03-02
 | |
| ### Added
 | |
| - Merged 2.8.1 changes that weren't reflected in 2.10.0 release
 | |
| ### Fixed
 | |
| - Fixing issues from SonarQube check
 | |
| - Updating obsolete API's that stopped working with recent Unity versions
 | |
| - Clarified how to add package in Unity project in documentation
 | |
| 
 | |
| ## [2.10.0] - 2021-11-01
 | |
| ### Added
 | |
| - Support for dynamic measurement count in Measure.Method and Measure.Frames
 | |
| 
 | |
| ## [2.9.0] - 2021-04-14
 | |
| ### Added
 | |
| - Support for overriding measurement count
 | |
| 
 | |
| ## [2.8.1] - 2021-03-16
 | |
| ### Removed
 | |
| - Setting up date when building player. It will set up at the beginning of the run.
 | |
| 
 | |
| ## [2.8.0] - 2021-03-16
 | |
| ### Added
 | |
| - Overloads to measurements for overriding sample unit
 | |
| ### Fixed
 | |
| - Cases where cleanup throws an exception
 | |
| 
 | |
| ## [2.7.0] - 2021-02-19
 | |
| ### Changed
 | |
| - Reduce metadata overhead when running locally by caching dependencies
 | |
| - Restructured documentation
 | |
| ### Removed
 | |
| - The need for link.xml
 | |
| ### Fixed
 | |
| - Method measurement IterationsPerMeasurement
 | |
| 
 | |
| ## [2.6.0] - 2021-01-12
 | |
| ### Added
 | |
| - Build configuration support
 | |
| 
 | |
| ## [2.5.1] - 2021-01-05
 | |
| ### Fixed
 | |
| - Serialization for Performance Test Report window
 | |
| 
 | |
| ## [2.5.0] - 2020-12-29
 | |
| ### Added
 | |
| - Domain reload support
 | |
| ### Changed
 | |
| - Switched from Newtonsoft.Json to Unity json module
 | |
| 
 | |
| ## [2.4.1] - 2020-11-05
 | |
| ### Changed
 | |
| - Metadata collection was made public
 | |
| 
 | |
| ## [2.4.0] - 2020-09-16
 | |
| ### Added
 | |
| Performance Test Report window updates:
 | |
| - CSV export option.
 | |
| - Monitoring of results file timestamp to support auto refresh when a new file is found.
 | |
| - Display of timestamp of last loaded results file.
 | |
| - Option to sort test report window by order the tests ran in (index). This is now the default.
 | |
| - Min and max to the table.
 | |
| - Improved titles and tooltips on columns
 | |
| ### Changed
 | |
| - Upgraded json dependency to release version
 | |
| - Reduced overhead introduced when running tests
 | |
| 
 | |
| ## [2.3.1] - 2020-07-01
 | |
| ### Fixed
 | |
| - Overhead introduced with Measure.Method no longer calculates execution time of Setup and Cleanup changes
 | |
| 
 | |
| ## [2.3.0] - 2020-06-17
 | |
| ### Fixed
 | |
| - Measure.Method overhead
 | |
| - Measure.Method no longer calculates execution time of Setup and Cleanup
 | |
| - Overwritten test name will be displayed with method name in Test Result viewer
 | |
| 
 | |
| ## [2.2.0] - 2020-05-26
 | |
| ### Added
 | |
| - Support for custom metadata
 | |
| 
 | |
| ## [2.1.0] - 2020-05-14
 | |
| ### Added
 | |
| - Flexible horizontal splitter for report window
 | |
| ### Fixed
 | |
| - Date format
 | |
| 
 | |
| ## [2.0.9] - 2020-03-23
 | |
| ### Fixed
 | |
| - Profiler measurements for method measurements
 | |
| - Throw exceptions when measuring NaN
 | |
| 
 | |
| ## [2.0.8] - 2020-02-20
 | |
| ### Fixed
 | |
| - Fix profiler marker capture when changing scenes in editor tests
 | |
| - Only shift samplegroups for UI
 | |
| 
 | |
| ## [2.0.7] - 2020-02-14
 | |
| ### Fixed
 | |
| - Results parsing
 | |
| 
 | |
| ## [2.0.6] - 2020-01-13
 | |
| ### Fixed
 | |
| - Development player field
 | |
| 
 | |
| ## [2.0.5] - 2020-01-13
 | |
| ### Changed
 | |
| - Disallow multiple performance attributes
 | |
| - Disallow empty samplegroup name
 | |
| - Assign samplegroup name to frames measurements
 | |
| 
 | |
| ## [2.0.4] - 2019-12-05
 | |
| ### Changed
 | |
| - Update json package to support AOT platforms
 | |
| 
 | |
| ## [2.0.3] - 2019-11-20
 | |
| ### Added
 | |
| - New fields to data format BuildTarget, StereoRenderingPath
 | |
| 
 | |
| ## [2.0.2] - 2019-11-20
 | |
| ### Changed
 | |
| - Increased test serialization version
 | |
| 
 | |
| ## [2.0.1] - 2019-11-20
 | |
| ### Fixed
 | |
| - Player callbacks when no tests were executed
 | |
| 
 | |
| ## [2.0.0] - 2019-11-19
 | |
| ### Added
 | |
| - Tests to package testables
 | |
| ### Changed
 | |
| - Refactored data format, reduced nesting
 | |
| - Slight refactor on measurement API
 | |
| - Shift sample units when printing results
 | |
| - Switched to newtosoft json package
 | |
| ### Removed
 | |
| - Unused fields
 | |
| - Deprecated attributes
 | |
| ### Fixed
 | |
| - Resources cleanup meta files
 | |
| 
 | |
| ## [1.3.1] - 2019-11-05
 | |
| ### Fixed
 | |
| - Warning after cleaning resources
 | |
| - Test suite when running in the editor
 | |
| 
 | |
| ## [1.3.0] - 2019-08-26
 | |
| ### Changed
 | |
| - Switch to errors from exceptions when parsing results
 | |
| - Increase minimum unity version to 2019.3
 | |
| ### Removed
 | |
| - Metadata collectors tests
 | |
| 
 | |
| ## [1.2.6] - 2019-08-22
 | |
| ### Changed
 | |
| - Categorize performance tests as performance
 | |
| - ProfilerMarkers can now be called with string params
 | |
| - Switch measuring frames and methods to stopwatch
 | |
| ### Removed
 | |
| - Profiler section on docs as the feature was removed
 | |
| 
 | |
| ## [1.2.5] - 2019-06-17
 | |
| ### Added
 | |
| - Test publish for CI
 | |
| 
 | |
| ## [1.2.4] - 2019-06-17
 | |
| ### Added
 | |
| - Test publish for CI
 | |
| 
 | |
| ## [1.2.3] - 2019-06-14
 | |
| ### Changed
 | |
| - Updated changelog
 | |
| 
 | |
| ## [1.2.2] - 2019-06-13
 | |
| ### Added
 | |
| - Support for domain reload
 | |
| 
 | |
| ## [1.2.1] - 2019-06-07
 | |
| ### Fixed
 | |
| - Bug that would cause player build failures
 | |
| 
 | |
| ## [1.2.0] - 2019-05-23
 | |
| ### Changed
 | |
| - Increase unity version to 2019.2
 | |
| 
 | |
| ## [1.1.0] - 2019-05-22
 | |
| ### Changed
 | |
| - Update assembly definition formats to avoid testables in package manifest
 | |
| 
 | |
| ## [1.0.9] - 2019-05-21
 | |
| ### Changed
 | |
| - Update scripting runtime setting for 2019.3
 | |
| 
 | |
| ## [1.0.8] - 2019-03-08
 | |
| ### Added
 | |
| - Automation test deploy
 | |
| 
 | |
| ## [1.0.7] - 2019-03-08
 | |
| ### Added
 | |
| - Automation test deploy
 | |
| 
 | |
| ## [1.0.6] - 2019-03-04
 | |
| ### Changed
 | |
| - Updated changelog
 | |
| 
 | |
| ## [1.0.5] - 2019-03-04
 | |
| ### Added
 | |
| - Conditional support for 2019.1
 | |
| 
 | |
| ## [1.0.4] - 2019-02-18
 | |
| ### Removed
 | |
| - Unnecessary meta files
 | |
| 
 | |
| ## [1.0.3] - 2019-02-18
 | |
| ### Changed
 | |
| - package.json update
 | |
| 
 | |
| ## [1.0.2] - 2019-02-18
 | |
| ### Changed
 | |
| - package.json update
 | |
| 
 | |
| ## [1.0.1] - 2019-02-18
 | |
| ### Changed
 | |
| - Updated Documentation to reflect breaking changes
 | |
| 
 | |
| ## [1.0.0] - 2019-02-15
 | |
| ### Changed
 | |
| - Refactor attributes
 | |
| 
 | |
| ## [0.1.50] - 2019-01-15
 | |
| ### Changed
 | |
| - Results paths to persistent data
 | |
| 
 | |
| ## [0.1.49] - 2018-12-04
 | |
| ### Changed
 | |
| - Revert changes to profiler and GC
 | |
| 
 | |
| ## [0.1.48] - 2018-11-22
 | |
| ### Changed
 | |
| - Doc updates and ignore GC api in editor due to api issues
 | |
| 
 | |
| ## [0.1.47] - 2018-11-14
 | |
| ### Removed
 | |
| - Debug logs
 | |
| 
 | |
| ## [0.1.46] - 2018-11-14
 | |
| ### Fixed
 | |
| - Breaking changes introduced by testrunner API rename
 | |
| 
 | |
| ## [0.1.45] - 2018-11-08
 | |
| ### Fixed
 | |
| - Breaking changes to data submodule
 | |
| 
 | |
| ## [0.1.44] - 2018-11-08
 | |
| ### Changed
 | |
| - Disable GC and update API to work around warning
 | |
| 
 | |
| ## [0.1.43] - 2018-10-30
 | |
| ### Fixed
 | |
| - Method measurements setup and cleanup
 | |
| 
 | |
| ## [0.1.42] - 2018-10-15
 | |
| ### Added
 | |
| - Button on report window to open profiler output for test
 | |
| - Save profiler output on perf tests
 | |
| ### Removed
 | |
| - Unsupported features for legacy scripting runtime
 | |
| - Unnecessary assembly definition
 | |
| ### Fixed
 | |
| - Version attribute for test cases
 | |
| 
 | |
| ## [0.1.41] - 2018-10-02
 | |
| ### Added
 | |
| - Test report graph
 | |
| 
 | |
| ## [0.1.40] - 2018-09-17
 | |
| ### Changed
 | |
| - Update documentation
 | |
| 
 | |
| ## [0.1.39] - 2018-09-14
 | |
| ### Removed
 | |
| - Duplicate module from docs
 | |
| 
 | |
| ## [0.1.38] - 2018-09-14
 | |
| ### Changed
 | |
| - Updated documentation
 | |
| 
 | |
| ## [0.1.36] - 2018-08-27
 | |
| ### Changed
 | |
| - ProfilerMarkers now take params as arguments
 | |
| 
 | |
| ## [0.1.35] - 2018-08-27
 | |
| ### Added
 | |
| Measure.Method improvements:
 | |
| - Add GC allocation to Measure.Method
 | |
| - Add setup/cleanup for Measure.Method
 | |
| - Move order of calls for Measure.Scope
 | |
| 
 | |
| ## [0.1.34] - 2018-08-16
 | |
| ### Fixed
 | |
| - Obsolete warnings
 | |
| 
 | |
| ## [0.1.33] - 2018-08-03
 | |
| ### Fixed
 | |
| - Obsolete warnings, doc update with modules and internals, ValueSource fix
 | |
| 
 | |
| ## [0.1.32] - 2018-07-09
 | |
| ### Added
 | |
| - Method and Frames measurements can now specify custom warmup, measurement and iteration counts
 | |
| 
 | |
| ## [0.1.31] - 2018-07-04
 | |
| ### Changed
 | |
| - Marked metadata tests with performance category
 | |
| 
 | |
| ## [0.1.30] - 2018-06-27
 | |
| ### Fixed
 | |
| - Method measurement
 | |
| 
 | |
| ## [0.1.29] - 2018-06-12
 | |
| ### Changed
 | |
| - Moving back to json in xml due to multiple instabilities
 | |
| 
 | |
| ## [0.1.28] - 2018-06-01
 | |
| ### Removed
 | |
| - json printing from output
 | |
| 
 | |
| ## [0.1.27] - 2018-05-31
 | |
| ### Added
 | |
| - Meta files to npm ignore
 | |
| 
 | |
| ## [0.1.26] - 2018-05-31
 | |
| ### Changed
 | |
| Preparing package for moving to public registry:
 | |
| - Inversed changelog order
 | |
| - Excluded CI files from published package
 | |
| 
 | |
| ## [0.1.25] - 2018-05-31
 | |
| ### Removed
 | |
| - Missing meta files
 | |
| 
 | |
| ## [0.1.24] - 2018-05-31
 | |
| ### Changed
 | |
| - Print out json to xml by default for backwards compatability
 | |
| 
 | |
| ## [0.1.23] - 2018-05-30
 | |
| ### Fixed
 | |
| - Issues with packman, bumping up version
 | |
| 
 | |
| ## [0.1.22] - 2018-05-29
 | |
| ### Added
 | |
| - Option to specify custom Measure.Method Execution and Warmup count
 | |
| 
 | |
| ## [0.1.21] - 2018-05-25
 | |
| ### Fixed
 | |
| - Issues introduced by .18 fix
 | |
| 
 | |
| ## [0.1.19] - 2018-05-24
 | |
| ### Changed
 | |
| - Package has been renamed to `com.unity.test-framework.performance` to match test framework
 | |
| 
 | |
| ## [0.1.18] - 2018-05-24
 | |
| ### Fixed
 | |
| - Fix SetUp and TearDown for 2018.1
 | |
| 
 | |
| ## [0.1.17] - 2018-05-23
 | |
| ### Changed
 | |
| - Refactor Method and Frames measurements
 | |
| - Metadata collected using internal test runner API and player connection for 2018.3+
 | |
| 
 | |
| ## [0.1.16] - 2018-05-09
 | |
| ### Fixed
 | |
| - Bug fix regarding measureme methods being disposed twice
 | |
| 
 | |
| ## [0.1.15] - 2018-05-02
 | |
| ### Fixed
 | |
| - Metadata test, the test was failing if a json file was missing for playmode tests
 | |
| 
 | |
| ## [0.1.14] - 2018-04-30
 | |
| ### Added
 | |
| - Addition of measuring a method or frames for certain amount of times or for duration
 | |
| - Introduced SampleGroupDefinition
 | |
| ### Changed
 | |
| - Refactored measuring methods
 | |
| ### Removed
 | |
| - Removes linq usage for due to issues with AOT platforms
 | |
| 
 | |
| ## [0.1.13] - 2018-04-15
 | |
| ### Added
 | |
| - Added total, std and sample count aggregations
 | |
| - Added sample unit to multi sample groups
 | |
| ### Removed
 | |
| - Removed totaltime from frametime measurements
 | |
| ### Fixed
 | |
| - Fixed android metadata collecting
 | |
| 
 | |
| ## [0.1.12] - 2018-04-11
 | |
| ### Changed
 | |
| - Naming
 | |
| ### Fixed
 | |
| - json serialization
 | |
| 
 | |
| ## [0.1.11] - 2018-04-09
 | |
| ### Fixed
 | |
| - 2018.1 internal namespaces
 | |
| 
 | |
| ## [0.1.10] - 2018-04-09
 | |
| ### Added
 | |
| - Added editmode and playmode tests that collect metadata
 | |
| ### Changed
 | |
| - Change fields to UpperCamelCase
 | |
| 
 | |
| ## [0.1.9] - 2018-04-06
 | |
| ### Added
 | |
| - json output for 2018.1 which will be printed after test run
 | |
| 
 | |
| ## [0.1.8] - 2018-04-03
 | |
| ### Fixed
 | |
| - Fix an exception on 2018.1
 | |
| 
 | |
| ## [0.1.7] - 2018-04-03
 | |
| ### Changed
 | |
| - Changed some of the names to match new convention
 | |
| - Addressed typos in docs
 | |
| - Multiple overloads replaced by using default arguments
 | |
| 
 | |
| ## [0.1.6] - 2018-03-28
 | |
| ### Added
 | |
| - Measure.Custom got a new overload with SampleGroup
 | |
| - Readme now includes installation and more examples
 | |
| 
 | |
| ## [0.1.5] - 2018-03-20
 | |
| ### Added
 | |
| - Checks for usage outside of Performance tests
 | |
| 
 | |
| ## [0.1.4] - 2018-03-20
 | |
| ### Added
 | |
| - System info to performance test output
 | |
| - Preparing for reporting test data
 | |
| 
 | |
| ## [0.1.3] - 2018-03-14
 | |
| ### Removed
 | |
| - Temporarily removing tests from the package into separate repo
 | |
| 
 | |
| ## [0.1.2] - 2018-03-14
 | |
| ### Fixed
 | |
| - Update for a missing bracket
 | |
| 
 | |
| ## [0.1.1] - 2018-03-14
 | |
| ### Added
 | |
| - Test output now includes json that can be used to parse performance data from TestResults.xml
 | |
| - Added defines to be compatible with 2018.1 and newer
 | |
| - Measurement methods can now take in SampleGroup as argument
 | |
| ### Removed
 | |
| - Removed unnecessary overloads for measurements due to introduction of SampleGroup
 | |
| 
 | |
| ## [0.1.0] - 2018-02-27
 | |
| ### This is the first release of *Unity Package performancetesting*.
 | |
| Initial version.
 |