Xamarin.Android applications use a linker in order to reduce the size of the application. The linker employes static analysis of your application to determine which assemblies are actually used, which types are actually used, and which members are actually used. The linker then behaves like a garbage collector, continually looking for the assemblies, types, and members that are referenced until the entire closure of referenced assemblies, types, and members is found. Then everything outside of this closure is discarded.

For example, the Hello, Android sample:

Linking results in a package that is 30% the size of the original (unlinked) package in 1.2.0, and 18% of the unlinked package in 4.0.1.

// To play along at home, Example must be in a different assembly from MyActivity.
public class Example {  // Compiler provides default constructor... }  [Activity (Label="Linker Example", MainLauncher=true)] public class MyActivity {  protected override void OnCreate (Bundle bundle)  {  base.OnCreate (bundle);   // Will this work?  var o = Activator.CreateInstance (typeof (ExampleLibrary.Example));  } }

The Link SDK Assemblies option only links assemblies that come with Xamarin.Android. All other assemblies are not linked.

The Link All Assemblies option links all assemblies.

The above example will work with the Don't Link and Link SDK Assemblies options, and will fail with the Link All Assemblies behavior, generating the following error:

E/mono (17755): [0xafd4d440:] EXCEPTION handling: System.MissingMethodException: Default constructor not found for type ExampleLibrary.Example. I/MonoDroid(17755): UNHANDLED EXCEPTION: System.MissingMethodException: Default constructor not found for type ExampleLibrary.Example. I/MonoDroid(17755): at System.Activator.CreateInstance (System.Type,bool) <0x00180> I/MonoDroid(17755): at System.Activator.CreateInstance (System.Type) <0x00017> I/MonoDroid(17755): at LinkerScratch2.Activity1.OnCreate (Android.OS.Bundle) <0x00027> I/MonoDroid(17755): at Android.App.Activity.n_OnCreate_Landroid_os_Bundle_ (intptr,intptr,intptr) <0x00057> I/MonoDroid(17755): at (wrapper dynamic-method) object.95bb4fbe-bef8-4e5b-8e99-ca83a5d7a124 (intptr,intptr,intptr) <0x00033> E/mono (17755): [0xafd4d440:] EXCEPTION handling: System.MissingMethodException: Default constructor not found for type ExampleLibrary.Example. E/mono (17755): E/mono (17755): Unhandled Exception: System.MissingMethodException: Default constructor not found for type ExampleLibrary.Example. E/mono (17755): at System.Activator.CreateInstance (System.Type type, Boolean nonPublic) [0x00000] in <filename unknown>:0 E/mono (17755): at System.Activator.CreateInstance (System.Type type) [0x00000] in <filename unknown>:0 E/mono (17755): at LinkerScratch2.Activity1.OnCreate (Android.OS.Bundle bundle) [0x00000] in <filename unknown>:0 E/mono (17755): at Android.App.Activity.n_OnCreate_Landroid_os_Bundle_ (IntPtr jnienv, IntPtr native__this, IntPtr native_savedInstanceState) [0x00000] in <filename unknown>:0 E/mono (17755): at (wrapper dynamic-method) object:95bb4fbe-bef8-4e5b-8e99-ca83a5d7a124 (intptr,intptr,intptr)

The Android.Runtime.PreserveAttribute can be used to explicitly add members to be preserved by the linker, and should be placed on a member when the linker would otherwise remove it. Thus, for the above example to work, we could either place [Preserve] on the constructor:

public class Example {  [Android.Runtime.Preserve]  public Example ()  {  } }

Or we could use [Preserve(AllMembers=true)] on the type to preseve all members. This is also useful for XML serialization:

[Android.Runtime.Preserve(AllMembers=true)] class Example {  // Compiler provides default constructor... }

[Activity (Label="Linker Example", MainLauncher=true)] class MyActivity {  #pragma warning disable 0219, 0649  static bool falseflag = false;  static MyActivity ()  {  if (falseflag) {  var ignore = new Example ();  }  } #pragma warning restore 0219, 0649   // ... }

It is possible to specify that a set of user-provided assemblies should not be linked at all, while allowing other user assemblies to be skipped with the Link SDK Assemblies behavior by using the AndroidLinkSkip MSBuild property:

<PropertyGroup>  <AndroidLinkSkip>Assembly1;Assembly2</AndroidLinkSkip> </PropertyGroup>