54f2dae935
This optimization can be enabled when it's not possible to use the managed linker (e.g. **Don't link**) or when the managed linker cannot remove references to deprecated types that would cause an application to be rejected by Apple. References to the existing types will be renamed, e.g. `UIWebView` to `DeprecatedWebView`, in every assemblies. The type definition is also renamed (for validity) and all custom attributes on the types and their members will be removed. Code inside the members will be replaced with a `throw new NotSupportedException ();`. The msbuild test app `MyReleaseBuild` has been updated to test that the optimization is working as expected (device builds are slow so reusing this test has little impact in test time). Basically the test ensure that `UIWebView` is used and cannot be removed by the compiler (optimization) or the managed linker (since it's referenced). Since the optimization is enabled then we can `grep` then final `.app` directory to ensure there's no mention of `UIWebView` inside any of the files that would be submitted. The application can be run, by itself, and will turn green if OK, red if `DeprecatedWebView` can't be found (skeleton replacement for `UIWebView`) or orange if a `NotSupportedException` is thrown. Finally introspection tests have been updated to skip over the deprecated (and renamed) types. It should not be an issue right now, since this optimization is not enabled by default, but it made testing easier. |
||
---|---|---|
.. | ||
xamarin-analysis-doc-tool | ||
Makefile | ||
README.md | ||
binding_objc_libs.md | ||
binding_types_reference_guide.md | ||
generator-errors.md | ||
mmp-errors.md | ||
mtouch-errors.md | ||
optimizations.md | ||
xamarin-ios-analysis.md |
README.md
This directory contains documentation files in markdown format.
They are included here to ensure any changes to
- Tools error codes;
- Binding attributes;
- Binding usage
are documented immediately, i.e. in the same commit that the change was introduced.
This also allows any contributor from the community to enhance the documentation with a pull-request.
The Makefile
can be used to copy the files into the documentation repo.
Once reviewed locally it can be merged just before the release.