Bug 287 - Updating the Minimum Android Version doesn't update TargetFrameworkVersion.
Summary: Updating the Minimum Android Version doesn't update TargetFrameworkVersion.
Alias: None
Product: Xamarin Studio
Classification: Desktop
Component: Android Add-in ()
Version: 2.6 Beta 3
Hardware: PC Mac OS
: --- normal
Target Milestone: ---
Assignee: shana@xamarin.com
Depends on:
Reported: 2011-08-12 17:42 UTC by Jonathan Pryor
Modified: 2011-08-23 11:02 UTC (History)
3 users (show)

Is this bug a regression?: ---
Last known good build:

Notice (2018-05-24): bugzilla.xamarin.com is now in read-only mode.

Please join us on Visual Studio Developer Community and in the Xamarin and Mono organizations on GitHub to continue tracking issues. Bugzilla will remain available for reference in read-only mode. We will continue to work on open Bugzilla bugs, copy them to the new locations as needed for follow-up, and add the new items under Related Links.

Our sincere thanks to everyone who has contributed on this bug tracker over the years. Thanks also for your understanding as we make these adjustments and improvements for the future.

Please create a new report on Developer Community or GitHub with your current version information, steps to reproduce, and relevant error messages or log files if you are hitting an issue that looks similar to this resolved bug and you do not yet see a matching new report.

Related Links:

Description Jonathan Pryor 2011-08-12 17:42:49 UTC
(Call it the wonderful case of information duplication...)

Tested against the Mono for Android MonoDevelop Add-in

Updating the minimum android version doesn't update the TargetFrameworkVersion. This needs to be done so that the appropriate Mono.Android.dll assembly is referenced at build time.

To reproduce:

 1. File -> New Solution / Mono for Android Application / Insert name ; OK.

 2. At this point, view ProjectDirectory/ProjectName.csproj. It has:


 3. In the Solution pane, select the project, then click 
    Project > ProjectName Options.

 4. In the tree view, select Build / Mono for Android Application.

 5. Click the Add Android manifest button.

 6. Set Minimum Android version to API Level 4 (Android v1.6).

 7. Click OK, save everything.

 8. View ProjectDirectory/ProjectName.csproj: it now has:


    Specifically, <TargetFrameworkVersion/> is unchanged.


 9. Build! (I'm using `build` as it's easier to capture output):

Tool /Developer/MonoAndroid/usr/lib/mandroid/../../bin/smcs execution started with arguments: /noconfig /debug:full /debug+ /optimize- /out:obj/Debug/ScratchTargetFrameworkVersion.dll Activity1.cs Resources/Resource.designer.cs Properties/AssemblyInfo.cs /target:library /define:"DEBUG;__ANDROID__;__ANDROID_1__;__ANDROID_2__;__ANDROID_3__;__ANDROID_4__;__ANDROID_5__;__ANDROID_6__;__ANDROID_7__;__ANDROID_8__" /reference:/Developer/MonoAndroid/usr/lib/mono/2.1/System.dll /reference:/Developer/MonoAndroid/usr/lib/mono/2.1/System.Xml.dll /reference:/Developer/MonoAndroid/usr/lib/mandroid/platforms/android-8/Mono.Android.dll /reference:/Developer/MonoAndroid/usr/lib/mono/2.1/System.Core.dll /warn:4

That's the source compilation line (smcs is executed). The important bit is:


In particular, "android-8", which is TargetFrameworkVersion v2.2. We're supposed to be referencing "android-4" (as that's what we set as the minimum android version).

Expected behavior:

After setting the minimum android version, the <TargetFrameworkVersion/> element needs to be updated as appropriate, so that when the project is built it refers to correct Mono.Android.dll assembly.
Comment 1 Mikayla Hutchinson [MSFT] 2011-08-23 10:58:40 UTC
This doesn't make sense. The target framework is the API level you're building against, the minimum version is the minimum version that app will run on. You can build against a newer API level version than the minimum OS version, as long as you detect the OS version at runtime, and limit your API use depending on the OS version.
Comment 2 Admin 2011-08-23 11:02:17 UTC
Ok, so this is what those two settings do:

TargetFramework allows you to use a specific version of the managed libraries.
Minimum Android version sets the minimum android that this application can run
on. Any android devices running versions lower than this won't have this
application available to install.

So, you can target a 2.2 framework, but you can say that your app runs on 1.6.
If you use things that aren't supported in 1.6, you need to check at runtime
which version you're running on and switch code paths appropriately.