Xamarin Forms Editor Control – How to Change the Height Dynamically ?

Xamarin Forms Editor Control – How to Change the Height Dynamically ?


When I was trying to create a UI with a multi-line editor control in Xamarin Forms, I got an issue that It does not extend its height when I was adding multiple lines like in Android message app, Whatsapp etc..

His is my first XAML code which I tried before solve the issue.

Project Structure

Image 1 : Project Structure


Image 2 : With Default Editor control

In this UI, you can see that is does not extend its height when enter multiple lines.

Here is the code before customizing the editor.

first code

Then I looked for a solution for how to do it..


The solution is Override Editor Controller. Inside the custom render, we have to call InvalidateMeasure() method inside the TextChanged event to invalidate the layout of this Xamarin.Forms.VisualElement.

invalidate mesasure

Image 3 : InvalidateMeasure method definition

Thanks @JulianPasquefor the solution.

How to add the custom render for the Editor in the app.

First I’ll create a class EditorXF inside the CustomRenderer folder. and inherit Xamarin.Forms.Editor class to the EditorXF.

Then create a constructor for  EditorXF and create an event for TextChanged and call InvalidateMeasure() inside the event.

dynamicEditor render

Image 4 : Editor Custom Render

Then what we have to do is, call the customized render in the XAML code of the View.

First we have to add the namespace of the EditorXF render in the XAML Vew.

renderer xaml

Image 5 : Add XML namespace  of the Custom Render

Then Change the replace the Editor control by EditorXF render control using local:EditorXF tag.


Image 6 : Call Customized Editor in Vew

Then run the app and we will be able to add multiple lines and extend the height of the editor control dynamically.


Image 7 : Extended Editor

You can Have the full solution here @GitHub ..


Enjoy !!!!   






Colombo Xamarin Meetup – June 2017 -[Session 2] – Xamarin Forms Rich UI Controls – By : Buddhima Kudagama

Session 2 : Xamarin Forms Rich UI Controls

Hi Guys, This is our 8th Meetup of Colombo Xamarin Meetup group. I’m happy to say you that we have successfully done our meetup on 29th June 2017 in CMS , Colombo with two sessions.

I have done the 2nd session about Xamarin Forms Rich User interface controls with a demo and this article is about my session.




Image 1 : Colombo Xamarin Meetup

Click below link to Download the Slide of Session 2 –

[Xamarin forms Rich UI Controls] : Meetup20170629.Buddhima.ppt

You can have the sample App here…


What are the the rich UI controls available for Xamarin forms ?

I found some third party controls which are available for xamarin forms and xamarin native development and here are some main providers and their controls…


Image 2 : Rich UI control providers

Syncfusion – https://www.syncfusion.com/products/xamarin

Infragistics – https://www.infragistics.com/products/xamarin

Telerik – http://www.telerik.com/xamarin-ui

DevExpress – https://www.devexpress.com/products/xamarin/

First of All you should have a idea about Layouts, Pages, Views and Controls in Xamain Forms Mobile applications..

So Please Use these reference to learn them…



How to Design the User Interface(UI) in Xamarin Forms ?

There are two main methods :

  1. Design using XAML (Extensible Application Markup Language)
  2. using C# code in code behind

but you can design the UI using both of them…

What’s going to do ?

Syncfusion is better to develop Xamarin apps because of …


  • It gives a community license
  • and It has large number of controls than other third-party control providers.
  • Its very flexible to use
  • Good customer support etc.

How to Get the Free Community License ?

To get the community licence, go to..



When you claim the license by registering with syncfusion , they will send you the licence code for the product and you have to use it in the installation of the package…

How to Get the Syncfusion Packages to the Application ?

There are two methods to get the packages..

  1. Get using NuGet
  2. Direct Download using web site

You can follow the user guide to see how to download and Install the package in both of above methods..

Click here to see the user guide for download and installation …


How to Download Syncfusion Xamarin from Nu Get ?

In Visual Studio go to …

  1. Tools -> Options -> NuGet Package Manager -> Package Sources. By default You can see default NuGet packages are there.
0. default packages.jpg

Image 3 : Add new packages to NuGet Gallery

  1. To Add Syncfusion packages, Click Add Button in the top Right side..
  2. Then Copy and paste below URL in the bottom of the window like following image..


When you add the name and source, Click “Update” and then Click “OK

1. add nuget.jpg

Image 4 : Add Syncfusion Packages to NuGet Gallery

Now you can search the Syncfusion controls in the NuGet Package manager in Visual Studio..

Now right Click on the Solution -> Manage NuGet Packages for Solution -> you will see the Package Manager dialogue like below and you will see the Syncfusion packages has been added in package sources drop down list..

2 sf in pkg mgr.jpg

Image 5 : Select Syncfusion Packages

Click on Syncfusion Packages and then the syncfusion packages will be loaded to the list.

3 packages will be loaded.jpg

Image 6 : Search NuGet packages

Syncfusion Controls for Xamarin

There are many useful controls for Xamarin has been provided by Syncfusion and I have added them to my power point Slide and please see to to get them..

You can see them here in their website..


and their user guide..


How to Manage References/Dependencies of Controls in a Xamarin Forms App ?

Here I have taken he dependencies for Syncfusion chart to explain how the dependencies need to be added to the solution.

4 references.jpg

Image 7 : Dependencies

I have highlighted Syncfusion.SfChart.XForms.dll in Green color here and It has been added to all projects in the solution. The reason is the dll contains the common xamarin forms features and behaviors of Chart controls for all projects. So it should be added to all.

And in Yellow color, I have highlighted the platform specific dll(class library) files that we have to be added to native projects.

The best practice is follow the Syncfusion user guide when adding dependencies to any of their controls.

You can have the List of dependencies here…


You have to take care of dependencies when you are adding the references manually to your projects.

But when you are adding any controls from NuGet, it automatically installed the necessary dependencies itself.

Lets Develop a Demo App

In the session I did show you how to add Syncfusion Auto Complete Control and how to customize it.

Now lets do from the scratch.. !

Lets add dependencies to the project..

I’m using Visual Studio 2017 for the demo and OS is Windows 10.

Open Visual Studio and Go to File -> New -> New Project

Select Cross-platform in the right side of the window and select Cross Platform app (Xamarin) in Left side which shows project templates..

Then Give a Name to the app. I’ll give “DemoApp” as the Name. and Click “OK”

6 Create project.jpg

Image 8 : Select Project type to create

Now you will see another window to Select the Project Template, UI technology and code sharing strategy.

I’ll select Blank app as Template, Xamarin forms as UI technology and PCL(Portable class library) as code sharing technology for my demo.

7 select type of ui.jpg

Image 9 : Select Template

Now the project will be created and you will see it like below… The project consists of PCL, Android, iOS and a UWP project.

8 default project.jpg

Image 10 : Created Solution with projects

Then I’ll add here three folders to separate Models, View Models and Views and then the project will be like below.

5 create project.jpg

Image 11 : Model, View and ViewModel folders Create

Now Lets Install the dependencies for Syncfusion Auto Complete Control (SfAutoComplete).

SfAutoComplete is a control just like a Combo box that we use in Windows and web application.

Syncfusion Auto Complete for Xamarin.Forms provides a simpler way to complete the text based on the letters that the we entered on the box. It also provides option to choose a suggestion from drop down or append a suggestion to the text directly.

For more info, Go to …


Install using NuGet

Right Click on the Solution and -> Manage NuGet Packages

Then Select the SfAutoComplete control, Add it to all project by check the check boxes in the right side of the window.

And then Click install… And follow below steps to add the package…

9 instal control.jpg

Image 12 : Add SfAutoComplete from NuGet

10 instal control.jpg

Image 13 : Conform install the package

11 instal control.jpg

Image 14 : Accept licence

Now you can see the SfAutoComplete libraries has been added to the projects inside the solution..

I’m going to create a Android application and so I’ll show here how the references has been added to PCL and Android projects..

12 added to pcl.jpg

Image 15 : SfAutoComplete reference has been added to PCL

13 added to android.jpg

Image 16 : SfAutoComplete references has been added to Android

Now, Lets Start Coding…

Create Model

First I’ll create a Model inside of the Model Folder which “Student”..

namespace DemoApp.Model
public class Student
private int id;
public int ID
get { return id; }
set { id = value; }
private string name;
public string Name
get { return name; }
set { name = value; }

private string image;
public string Image
get { return image; }
set { image = value; }

Create View Model

And will Create A ViewModel inside the ViewModel folder as “StudentViewModel”. and I have created a Collection of Stundets in it as “StudentCollection”.

namespace DemoApp.ViewModel
public class StudentViewModel
private List<Student> studentCollection;
public List<Student> StudentCollection
get { return studentCollection; }
set { studentCollection = value; }

public StudentViewModel()
studentCollection = new List<Student>();
studentCollection.Add(new Student() { ID = 1, Name = "Buddhima", Image = "Student.png"});
studentCollection.Add(new Student() { ID = 2, Name = "Buddhika", Image = "Student.png"});
studentCollection.Add(new Student() { ID = 3, Name = "Dickson", Image = "Student.png" });
studentCollection.Add(new Student() { ID = 4, Name = "Janith", Image = "Student.png"});
studentCollection.Add(new Student() { ID = 5, Name = "Vidura", Image = "Student.png"});
studentCollection.Add(new Student() { ID = 6, Name = "Charitha", Image = "Student.png" });
studentCollection.Add(new Student() { ID = 7, Name = "Vimukthi", Image = "Student.png"});
studentCollection.Add(new Student() { ID = 8, Name = "Buddhi", Image = "Student.png"});
studentCollection.Add(new Student() { ID = 9, Name = "Buwaneka", Image = "Student.png"});

in the above code you can see there is a property called “Image” which is a image to show the student. So I have added an  Image in the Android project.

To add Images we have to go to Resources folder in Android project and there are separate folders to add images for different dimensions of devices which are drawable, drawable-hdpi, drawable-xhdpi, drawable-xxhdpi. The image has to be added to all folders according to compatible sizes with the same name.

14 Image added.jpg

Image 17 : Add Images

Design the View/User Interface

Right Click on Views folder and Click Add..

Select Xamarin forms -> and Content page as template -> Give a name -> Click OK

15 add view.jpg

Image 18 : Add a View

Then the View will be added inside of the folder with its default template with a XAML UI and a C# code behind class. (StudentView.xaml and StudentView.xaml.cs).

StudentView.xaml may be like below code…

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" x:Class="DemoApp.View.StudentView">
<Label Text="Welcome to Xamarin Forms!" />

StudentView.xaml.cs may be like below code…

using Xamarin.Forms;
using Xamarin.Forms.Xaml;

namespace DemoApp.View
public partial class StudentView : ContentPage
public StudentView()

[XamlCompilation(XamlCompilationOptions.Compile)] annotation use to increase the performance of the UI in compiling which has been designed using XAML.

Now lets add the SfAutoComple to the View.

To Add any third-party Control to the XAML UI, we have to add its namespace into the Header of the Page.

So, I’ll add the namespace of SfAutoComplete  to the header of the Content Page.


And I’ll add the control inside a Stack layout.. The design of the view should be add inside the  tag.

We can call the control by the namespace that we have added to the page header and here you can see how we can call the SfAutoComplete control.


And then the Code of the view like below. You can see a label also inside the Stack layout which has added when create the form.

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" xmlns:autocomplete="clr-namespace:Syncfusion.SfAutoComplete.XForms; assembly=Syncfusion.SfAutoComplete.XForms" x:Class="DemoApp.View.StudentView">
<Label Text="Auto Complete control" />

Then Lets Bind Data to the SfAutoComplete control

I’m going to bind Student Collection as data to the control using MVVM pattern. and there are two ways to Bind data using MVVM (Model View ViewModel).

  1. using XAML
  2. using C# in code behind

SfAutoComplete Control allow us to Bind a List of Strings or a List of Business Objects as the DataSource. In this Example I’m binding a List of Students to the control.

To learn more about MVVM in Xamain Please follow these links..



In this example, I’ll bind data using XAML.  And will set the Binding context to the View using code behind.

Now I’mm Bind the Student View Model to the StudentView Page. We have to set the binding context inside the constructor of the view page.

public partial class StudentView : ContentPage
public StudentView()
this.BindingContext = new ViewModel.StudentViewModel();

And then need to Bind the DataSource to the SfAutoComplete Control. In XAML page, bind StudentCollection List in the StudentVoewModel to the DataSource Property as below.

<autocomplete:SfAutoComplete DataSource="{Binding StudentCollection}">

Set the Student View Startup page …

Set the main page to StudentView in App.xaml.cs in PCL project..

public App()

MainPage = new DemoApp.View.StudentView();

But when you run the android app, it will not show the data inside of the control.

The reason is you haven’t bind the display value to it.

Then Lest set the additional attributes..

Now we can set which value can be show inside the Control and what will be the Selected Value of the control.

DisplayMemberPath – What should me the display member

SelectedValuePath – what should be the selected value

<autocomplete:SfAutoComplete DataSource="{Binding StudentCollection}" DisplayMemberPath="Name" SelectedValuePath="ID">

Lets compile and run the app  and it will show the list of students when searching..  By default it suggest data by the starting characters that we are typing.


16 basic data binding.png

Image 18 : Simple SfAutoComplete with Data Binding

So, we have to set the Suggestion mode too. And also we can set the Autocomplete Mode too.

Lets Do it ..

There are 8 main suggestion modes and I’ll select “StartsWith”

17. suggession mode.jpg

Image 19 : Suggestion modes in SfAutoComplete

There are 3 Auto Complete modes and I’ll select “Suggest”.

18 auto complete mode.jpg

Image 20 : Auto Complete modes in SfAutoComplete

Now Lets Customize the AutoComplete control..

now I want to show Student’s image, Name inside the control when searching..

So, I’ll add a data template to the AutoComplete control now.

to do it, we can use the autocomplete:SfAutoComplete.ItemTemplate tag. and we can and we can design the template inside it. in this example I’ll use a Grid View to design the template and below you can see the code. Also I have bind data to the controls which are in the grid.

<Label Text="Welcome to Xamarin Forms!" />
<autocomplete:SfAutoComplete DataSource="{Binding StudentCollection}" DisplayMemberPath="Name" SelectedValuePath="ID" SuggestionMode="StartsWith" AutoCompleteMode="Suggest" >
<RowDefinition Height="Auto"/>
<ColumnDefinition Width="Auto"/>
<ColumnDefinition Width="*"/>
<Image Grid.Row="0" Grid.Column="0" Source="{Binding Image}" WidthRequest="30" VerticalOptions="FillAndExpand"/>
<Label Grid.Row="0" Grid.Column="1" Text="{Binding Name}" HorizontalOptions="FillAndExpand"/>

Lets Run the app…

19 custom auto complete.png

Image 21 : Customized SfAutoComplete

It runs successfully…

For more details about SfAutoComplete control please go to this link and you will be able to learn more about it… Including events, Customize the design etc…


You can have the sample App here…




Thank you !

ListView Height Issue in Xamarin Forms – How to Solve it ?


When I was trying to add few items(1-2) to a List View in Xamarin forms inside of a Stack Layout, Its height does not automatically set according to the number of rows and there will be a empty space.


So I tried different things to solve the issue and finally I found a solution.


The solution is we have to set the Height of the list view according to the height of number of rows manually in code behind.

And also we can solve it using MVVM dynamically. Please click here to go to the article…

Here are steps to Solve the issue..

  1. Create a new Xamarin forms project with a PCL.
  2. Add a List View in a Stack layout i the MainPage.(But you can do this in your view page)

3 list view unregular code

&lt;?xml version="1.0" encoding="utf-8" ?&gt;
&lt;ContentPage xmlns="http://xamarin.com/schemas/2014/forms"              xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"              xmlns:local="clr-namespace:ListViewApp"              x:Class="ListViewApp.MainPage"&gt;

            &lt;BoxView HeightRequest="10" HorizontalOptions="FillAndExpand"/&gt;
            &lt;Image Grid.Row="0" Grid.Column="1" HorizontalOptions="Center" VerticalOptions="Center" 		        	 HeightRequest="100" WidthRequest="100" Source = "User.png"&gt;
            &lt;Label Text="  Friends " HorizontalOptions="FillAndExpand" BackgroundColor="#C7FCE1" FontSize="Large"/&gt;
            &lt;ListView x:Name="listViewFriends"  HasUnevenRows="true" SeparatorVisibility="Default" VerticalOptions="Fill"&gt;
                                        &lt;RowDefinition Height="Auto"/&gt;
                                        &lt;RowDefinition Height="Auto"/&gt;
                                        &lt;ColumnDefinition Width="20"/&gt;
                                        &lt;ColumnDefinition Width="Auto"/&gt;
                                        &lt;ColumnDefinition Width="*"/&gt;
                                        &lt;ColumnDefinition Width="20"/&gt;
                                    &lt;Image Grid.Row="0" Grid.Column="1" Grid.RowSpan="2"                                        WidthRequest="40" HeightRequest="40" Source = "Friend.png"&gt;
                                    &lt;Label Grid.Row="0" Grid.Column="2" Text="{Binding Name}" FontSize="Medium" TextColor="#065C2B"/&gt;
                                    &lt;Label Grid.Row="1" Grid.Column="2" Text="{Binding Email}" FontSize="Small" TextColor="#6FCF97"/&gt;
            &lt;Button Text="Add New Friend" TextColor="White" BackgroundColor="#01148E" FontAttributes="Bold" HorizontalOptions="FillAndExpand"/&gt;
            &lt;Button Text="Delete Friend" TextColor="White" BackgroundColor="#B61515" FontAttributes="Bold" HorizontalOptions="FillAndExpand"/&gt;

3.Then Bind data to the List View in the code behind.

(You can Bind data using MVVM. But Here I’ll bind a collection in a simple way).

Here I have created a Model called “Friend” to create the collection of Friends.

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Xamarin.Forms;
using Xamarin.Forms.Xaml;

namespace ListViewApp
public partial class MainPage : ContentPage
public MainPage()
listViewFriends.ItemsSource = GetFriends();

/// &lt;summary&gt;
/// Get Messages to Message List
/// &lt;/summary&gt;
/// &lt;returns&gt;&lt;/returns&gt;
private ObservableCollection&lt;FriendModel&gt; GetFriends()
ObservableCollection&lt;FriendModel&gt; collection = new ObservableCollection&lt;FriendModel&gt;();
collection.Add(new FriendModel() { ID = 1, Name = "Friend 1", Email = "friend1@sample.com" });
collection.Add(new FriendModel() { ID = 1, Name = "Friend 1", Email = "friend1@sample.com" });
listViewFriends.HeightRequest = (40 * collection.Count)+(10* collection.Count);
catch (Exception)
return collection;

public class FriendModel
public string Name { get; set; }
public string Email { get; set; }
public int ID { get; set; }


4. Then Run the code and you can see a list view with a empty area..


5. So we have to reduce the Height of the List view.

Lets see the XAML structure of the list view. The List view contains a grid view as the template. And the grid view has 2 rows. It consists of a image with has the row-span=2. That means  normally the height of one item of the List view is equal to the height of the image.

So then I’ll set the

Height(HeightRequest property of ListView) = Number of items * Height of one Item

I have added the code inside of the GetFriends() Method.

4 add a height

private ObservableCollection&lt;FriendModel&gt; GetFriends()
ObservableCollection&lt;FriendModel&gt; collection = new ObservableCollection&lt;FriendModel&gt;();
collection.Add(new FriendModel() { ID = 1, Name = "Friend 1", Email = "friend1@sample.com" });
collection.Add(new FriendModel() { ID = 1, Name = "Friend 1", Email = "friend1@sample.com" });
listViewFriends.HeightRequest = (40 * collection.Count);
catch (Exception)
return collection;

6. Then Run the app again.. And you may see the allocated size is now enough for the list view.


7. So What Should we do ?

According to that a Item(row) in a List view acquire extra space other than the height of the controls inside it. Normally it may be 10px.

So we have to add it  to the height of the ListView.

HeightRequest = (No.of items * Height of one Item) +(Default space + No.of items)

5 add a height plus padding

/// &lt;summary&gt;
/// Get Messages to Message List
/// &lt;/summary&gt;
/// &lt;returns&gt;&lt;/returns&gt;
private ObservableCollection&lt;FriendModel&gt; GetFriends()
ObservableCollection&lt;FriendModel&gt; collection = new ObservableCollection&lt;FriendModel&gt;();
collection.Add(new FriendModel() { ID = 1, Name = "Friend 1", Email = "friend1@sample.com" });
collection.Add(new FriendModel() { ID = 1, Name = "Friend 1", Email = "friend1@sample.com" });
listViewFriends.HeightRequest = (40 * collection.Count)+(10* collection.Count);
catch (Exception)
return collection;

8. Then Run the code and It will be provide the expected result.


Thanks !

How to Check the App is running for the First time – in Xamarin Forms (Android/iOS/Windows)


In one of my Xamarin Forms apps, I wanted to check is the app running for the first time after the installation or the app is already installed and according to that Load different pages in the app

 How to Install Xamarin in Visual Studio 2017…


  1. If the App is running for the first time, I wanted to a Quick Start Guide to the user.
  2. If all has already installed, app will show the Login Form.


Then I looked for a solution and James Montemagno‘s  SettingsPlugin gave me the solution…

If you want to learn more, Click above links to go to GitHub and  MotzCod.es.

How I did it ?

First I went through the Instruction of the above references and I installed the plugin using NuGet..

Here I’ll explain how I did it.. and Here is my project at the beginning.


1. First Install the Settings Plugin using NuGet packages.. Search  “Xam.Plugins.Settings”


2. Apply The package to all projects or selected projects.. (But I’m managing the settings from the PCL project) and Install the package..


3. Then Conform the installation..


4. When the packages has installed, It will generate a folder which is “Helpers” and a class onside it “Settings.cs” to manage settings.

It will added to all selected projects.


The default Settings class includes below C# code to manage settings..

using Plugin.Settings;
using Plugin.Settings.Abstractions;

namespace FirstTimeUse.Droid.Helpers
/// This is the Settings static class that can be used in your Core solution or in any
/// of your client applications. All settings are laid out the same exact way with getters
/// and setters.
/// &amp;lt;/summary&amp;gt;

public static class Settings
private static ISettings AppSettings
return CrossSettings.Current;

#region Setting Constants

private const string SettingsKey = "settings_key";
private static readonly string SettingsDefault = string.Empty;

public static string GeneralSettings
return AppSettings.GetValueOrDefault&amp;lt;string&amp;gt;(SettingsKey, SettingsDefault);
AppSettings.AddOrUpdateValue&amp;lt;string&amp;gt;(SettingsKey, value);


To read the more about the Settings class go to:  https://github.com/jamesmontemagno/SettingsPlugin

I’m going to store my value in the SettingsKey property. So I’ll change the default value of the SettingsKey property to “yes”. Which means the app is running for the first time.


private static readonly string SettingsDefault = "yes";

5. Now I’m going to use the Settings in the application..

I’m checking the app status in the App.xaml.cs class. Because the app navigating to the Main page happens in the constructor in App.xaml.cs class.

The default code of the App class is… And there are not properties in this class…

public partial class App : Application
public App()
MainPage = new MainPage();

protected override void OnStart()
// Handle when your app starts

protected override void OnSleep()
// Handle when your app sleeps

protected override void OnResume()
// Handle when your app resumes

Now I’ll add a Property to App class to Manage App Settings. The property name is “IsFirstTime” and type is String.


/// Get and Set value to General settings
/// &amp;lt;/summary&amp;gt;

public string IsFirstTime
get { return Settings.GeneralSettings; }
if (Settings.GeneralSettings == value)
Settings.GeneralSettings = value;

6. Now I’ll add another page to use for log in to system if the app has already installed.

Page name is “LoginPage.xaml”.


7. Now Lets Write code in App.xaml.cs to check the app status…

The page is initialize in the constructor of the App class. So I’m going to check the status of the app inside of the constructor.

And Here is the code. In the Settings class, I have set the default value as “yes“. So the app runs for the first time, the value should be “yes“. Then  the MainPage page will open. And when the app ran for the first time, it  sets the “IsFirstTime value to “no“.

Then when the user run the app after the first time, it will load the second page which is Logging Page.


public App()

// Check is the app running for the first time
if (IsFirstTime == "yes")
// if this is the first time, set it to "No" and load the
// Main Page ,which will show at the first time use
IsFirstTime = "no";
MainPage = new FirstTimeUse.MainPage();
// If this is not the first time,
// Go to the login page
MainPage = new FirstTimeUse.LoginPage();

8. The Build and run the app using emulator. I’m using my Samsung Galaxy J7 as the emulator. And the App was run  successfully.


First time it will open the Main Page


And When I run the app after the first time, It loads the Login page..






Thanks !

Convert from Multilingual App Toolkit v3.0 to v4.0 and Fix Error “The Multilingual App Toolkit v4.0 is not compatible with previous versions of the toolkit”


I used Multilingual App Toolkit 3.0 for my Xamarin application in Visual Studio 2013 in Windows 8.1. Then I moved to a new machine with windows 10 and I installed Visual Studio 2015. Then I opened that Xamarin project in VS 2015 and when I was building the project it gave me an error.

mla error 1

Image 1 : Error


The imported project “C:\Program Files (x86)\MSBuild\Microsoft\Multilingual App Toolkit\Microsoft.Multilingual.ResxResources.targets” was not found.

Confirm that the path in the <Import> declaration is correct, and that the file exists on disk.


F:\ProjectsBuddhima\mobile\Mobility\Mobility App\Mobility_App.csproj


Then I searched solutions for the error and according to the error, my new machine has not installed Multilingual App Toolkit.

Solution and Next steps

So I installed Multilingual App Toolkit v.4.0 which is compatible with Visual Studio 2015.

You can download from


mla error 2

Image 2 : Download Multilingual App Toolkit v4.0

Then the installer will download to your machine and you have to install it manually.

After I installed Multilingual App toolkit 4.0 I built the project again and I got another error.

Multilingual App Toolkit v4.0 upgrade blocked

The Multilingual App Toolkit v4.0 is not compatible with previous versions of the toolkit

mla error 7

Image 3 : Multilingual app Toolkit is blocked

According to above error message, I browsed the link in the http://aka.ms/mat4faq

According to their technical references I will describe steps to convert from v3 to v4.

  1. First take a backup of existing project.
  2. Then we have to open the project which has Multilingual App toolkit v3.
  3. Then we have to disable app toolkit for projects. Go to tools and click “Disable Multilingual App Toolkit”.

    1 disable MLA tool kit

    Image 4 : Disable MLA Toolkit

  4. Then Copy current .xlf files to another location as a backup and delete all .xlf files in the project.

    2 remove xlf files

    Image 5 : Remove current XLF files

  5. Then rebuild the project.


Sometimes these steps are not enough to fully disable toe Multilingual App toolkit. So we have to disable it using config file manually.

Here are steps to remove them manually.

1.Right click the config file in the project and open it.
2.Search the label “MultilingualAppToolkit” in the config file.

12 multi languala app label

Image 6 : Delete property group from config file

3.Then delete above <PropertyGroup> which contains <MultilingualAppToolkitVirsion> tag.
4.Then we have to search again “MultilingualAppToolkit” label. And you will see <import> element.

13 delete multi languala import label

Image 7 : Delete <import> tag which contains MLA label

And also we have to delete the <Import> tag which contains “MultilingualAppToolkit”.


5.Then rebuild the project.

Now we have removed configurations of Multilingual App Toolkit from our project and we are ready to add v4.0 configurations.

Then we have to enable Multilingual App Toolkit from Toolbox.

1 Enable mltk

Image 8 : Enable MLA Toolkit

When we enable the Multilingual App Toolkit v4.0, we are ready to recycle Transitions from v3.0 project’s .xlf files.

Below I have added steps for that.

1.  Please check that the Multilingual App Toolkit v4.0 is enabled.

2. Then click on the project and select Multilingual App Toolkit=> Add transition languages

3 add multilangual languages

Image 9 : Multilingual App Toolkit ->  Add Transition languages

3. We can see language list in a window like below. Select languages that previously we have added to the project.

4 select languages

Image 10 : Select Languages

When click “OK”. New xlf files will be added to our project in a folder called “MultilingualResources”.  Below image shows it.

5 added xlf files

Image 11 : Added XLF files for selected languages

4. Then click on “MultilingualAppResources” folder and click .. Multilingual App Toolkit=> Import / recycling translations

6 import recycling transactions

Image 12 : Multilingual App Toolkit -> Import/Recycle Transitions

Then you will see below window.

7 import recycling transactions

Image 13 : Import Transition window

5. Click “Add button” and then select v3 xlf files from the location that we have copied from previous project.

8 select old v3 files

Image 14 : Select and Add  XML files in v3 project.

6. Then Select xlf files that we copied from the temporary location and Click “Open”. Then selected xlf files will be added to import resources form.

9 seletec xlf v3 files

Image 15 : Added XLF files

7. And an Important thing is we have to check the “Enable resource recycling” check box. And then click the import button.

10 enable recycling and import

Image 16 : Enable resource recycling and Import

8. Then rebuild the project.

11 success

Image 17 : Successfully Built project

Then we can see those .xlf files has been added to project and the project has built successfully.

Thank you !