xamarin-macios/tests/introspection
Sebastien Pouliot 07c81479e2
[tests][intro] Clean up old and some non-required availability attributes (#3141)
We normally frown on large scale _cosmetic_ changes, mostly because it breaks git's history (very useful) and makes merging branches harder and more error prone (very annoying).

However we require, right now, such changes to remove our old, mcs-based, pre-processor (pmcs) so it's a _good_ time to address the old, unneeded availability attributes - since most of them are re-written for our next milestone.

This won't change the final application size in most cases, as the linker removes them, but it will make the (unlinked) platform assemblies smaller. This means they will load faster (e.g. by mtouch, mmp, IDE, workbooks...) and will reduce the time/memory needed to reflect them.
2018-01-02 11:28:55 -05:00
..
Mac [tests][intro] Clean up old and some non-required availability attributes (#3141) 2018-01-02 11:28:55 -05:00
iOS [tests][intro] Clean up old and some non-required availability attributes (#3141) 2018-01-02 11:28:55 -05:00
ApiAvailabilityTest.cs [tests][intro] Clean up old and some non-required availability attributes (#3141) 2018-01-02 11:28:55 -05:00
ApiBaseTest.cs Merge xcode9 into d15-4[-xi] (#2710) 2017-09-15 17:53:16 -04:00
ApiCMAttachmentTest.cs [tvos][videotoolbox] Enable VideoToolbox.framework on tvOS (#1626) 2017-03-28 09:22:10 -05:00
ApiClassPtrTest.cs Move parts of dontlink tests into new introspection tests (#32) 2016-05-04 20:14:32 -04:00
ApiCoreImageFiltersTest.cs [CoreImage] Update filters for Xcode 9 (#2974) 2017-11-16 16:38:14 -05:00
ApiCtorInitTest.cs [src] Properly annotate designated initializers in many frameworks (#3142) 2017-12-28 16:37:13 -05:00
ApiFieldTest.cs Merge xcode9 into d15-4[-xi] (#2710) 2017-09-15 17:53:16 -04:00
ApiPInvokeTest.cs [tests][intro] Add validation for methods decorated with [MonoPInvokeCallback] (#1751) 2017-03-04 19:40:35 -05:00
ApiProtocolTest.cs [MetalPerformanceShaders] Xcode 9 bindings (#3005) 2017-11-28 14:29:05 -06:00
ApiSelectorTest.cs [MetalPerformanceShaders] Xcode 9 bindings (#3005) 2017-11-28 14:29:05 -06:00
ApiSignatureTest.cs Merge xcode9 into d15-4[-xi] (#2710) 2017-09-15 17:53:16 -04:00
ApiStructTest.cs Move parts of dontlink tests into new introspection tests (#32) 2016-05-04 20:14:32 -04:00
ApiTypoTest.cs Remove PMCS processing of availability attributes (#3096) 2017-12-22 13:03:21 -06:00
ApiWeakPropertyTest.cs [homekit] Expose weakly-typed API since the constants are extensible. Fixed #60303 (#3025) 2017-11-21 20:50:33 -05:00
CoreSelectorTest.cs [macos] Fix introspection tests (typo + NSUrlSession* test sharing) 2016-09-06 13:32:51 -04:00
EnvironmentVariable.cs Move parts of dontlink tests into new introspection tests (#32) 2016-05-04 20:14:32 -04:00
README.md [tests] Move linker tests from maccore (#69) 2016-05-20 14:07:34 -04:00
xamarin1.png Move parts of dontlink tests into new introspection tests (#32) 2016-05-04 20:14:32 -04:00

README.md

Introspection Tests

Introspection tests are executed on target (both simulator and device for iOS) or a specific version of OSX. The application proceed to analyze itself using:

  • System.Reflection for managed code; and
  • the ObjectiveC runtime library for native code

and compare the results. E.g. if using .NET reflection it can see a binding for a NSBundle type then it should be able to find a native NSBundle type using the ObjC runtime functions. Otherwise an error is raised...

Since the application analyze itself it must contains everything we wish to test. That's why the introspection tests needs to be built with the managed linker disable, i.e. "Don't link".

Pros

  • The tests always tell the truth, which can differ from documentation or header files;

Cons

  • Incomplete - Not everything is encoded in the metadata / executable;
  • Too complete - Not every truth is good to be known (or published), which requires creating special cases in the tests