Xamarin September – Light Game

Standard

Step 1

If not already, follow Setup and Start on how to Install and get Started with Visual Studio 2017 or in Windows 10 choose Start, and then from the Start Menu locate and select Visual Studio 2017.

xamarin-vs2017-home

Step 2

Once Visual Studio Community 2017 has started, from the Menu choose File, then New then Project…

xamarin-vs2017-file-new-project

Step 3

From New Project choose Visual C# from Installed, Templates then choose Cross Platform App (Xamarin) and then type in a Name and select a Location and then select Ok to create the Project

xamarin-vs2017-new-project

Step 4

Then in New Cross Platform App you need to select the Blank App Template then from UI Technology select Xamarin.Forms and in Code Sharing Strategy select Shared Project and then select Ok to continue

xamarin-vs2017-cross-platform

Step 5

The Xamarin Mac Agent will be displayed allowing connection to an Apple Mac but this can be dismissed with Close if running solely on Windows 10

xamarin-vs2017-mac-agent

Step 6

Then in New Universal Windows Project you need to select the Target Version to be Windows 10 Creators Update (10.0; Build 15063) and the Minimum Version to Windows 10 Creators Update (10.0; Build 15063) and then select Ok

xamarin-vs2017-target

Step 7

From the Menu choose Project, then Add New Item…

xamarin-vs2017-add-new-item

From the Add New Item choose Visual C# from Installed then choose Code then select Code File and then in the Name as Library.cs and then select Add to add the file to the Project

xamarin-vs2017-library

Step 9

Then in the Code View for Library.cs the following should be entered:

using Xamarin.Forms;
using System.Linq;

public class Library
{
    private const int size = 7;
    private const int on = 1;
    private const int off = 0;

    private readonly Color lightOn = Color.White;
    private readonly Color lightOff = Color.Black;

    private ContentPage _page;
    private int _moves = 0;
    private bool _won = false;
    private int[,] _board = new int[size, size];

    public void Show(string content, string title)
    {
        Device.BeginInvokeOnMainThread(() => {
            _page.DisplayAlert(title, content, "Ok");
        });
    }

    private bool Winner()
    {
        for (int row = 0; row < size; row++)
        {
            for (int column = 0; column < size; column++)
            {
                if (_board[column, row] == on)
                {
                    return false;
                }
            }
        }
        return true;
    }

    private void Toggle(Grid grid, int row, int column)
    {
        _board[row, column] =
            _board[row, column] == on ? off : on;
        Grid element = (Grid)grid.Children.Single(
            w => Grid.GetRow((Grid)w) == row
            && Grid.GetColumn((Grid)w) == column);
        element.BackgroundColor =
            _board[row, column] == on ? lightOn : lightOff;
    }

    private void Add(Grid grid, int row, int column)
    {
        Grid element = new Grid()
        {
            HeightRequest = 40,
            WidthRequest = 40,
            BackgroundColor = lightOn
        };
        TapGestureRecognizer tapped = new TapGestureRecognizer();
        tapped.Tapped += (sender, e) =>
        {
            if (!_won)
            {
                element = ((Grid)(sender));
                row = (int)element.GetValue(Grid.RowProperty);
                column = (int)element.GetValue(Grid.ColumnProperty);
                Toggle(grid, row, column);
                if (row > 0)
                {
                    Toggle(grid, row - 1, column); // Toggle Left
                }
                if (row < (size - 1))
                {
                    Toggle(grid, row + 1, column); // Toggle Right
                }
                if (column > 0)
                {
                    Toggle(grid, row, column - 1); // Toggle Above
                }
                if (column < (size - 1))
                {
                    Toggle(grid, row, column + 1); // Toggle Below
                }
                _moves++;
                if (Winner())
                {
                    Show("Well Done! You won in " + _moves + " moves!", "Light Game");
                    _won = true;
                }
            }
        };
        element.GestureRecognizers.Add(tapped);
        element.SetValue(Grid.ColumnProperty, column);
        element.SetValue(Grid.RowProperty, row);
        grid.Children.Add(element);
    }

    private void Layout(ref Grid grid)
    {
        _moves = 0;
        grid.Children.Clear();
        grid.ColumnDefinitions.Clear();
        grid.RowDefinitions.Clear();
        grid.BackgroundColor = Color.LightGray;
        // Setup Grid
        for (int index = 0; (index < size); index++)
        {
            grid.RowDefinitions.Add(new RowDefinition());
            grid.ColumnDefinitions.Add(new ColumnDefinition());
        }
        for (int row = 0; (row < size); row++)
        {
            for (int column = 0; (column < size); column++)
            {
                Add(grid, row, column);
            }
        }
    }

    public void New(ContentPage page, Grid grid)
    {
        _page = page;
        Layout(ref grid);
        _won = false;
        // Setup Board
        for (int column = 0; (column < size); column++)
        {
            for (int row = 0; (row < size); row++)
            {
                _board[column, row] = on;
            }
        }
    }
}

Step 10

In the Solution Explorer select MainPage.xaml from the Shared Project

xamarin-vs2017-library-mainpage-xaml

Step 11

From the Menu choose View and then Open

xamarin-vs2017-view-open

Step 12

The XAML View will be displayed, and in this remove the Label then between the ContentPage and /ContentPage elements, enter the following XAML:

<Grid>
	<Grid.RowDefinitions>
		<RowDefinition Height="*" />
		<RowDefinition Height="Auto" />
	</Grid.RowDefinitions>
	<Grid Grid.Row="0" x:Name="Display" HorizontalOptions="Center" VerticalOptions="Center"/>
	<Grid Grid.Row="1" Margin="10">
		<Button Text="New" HorizontalOptions="Center" WidthRequest="100" Clicked="New_Clicked"/>
	</Grid>
</Grid>

It should appear as such:

xamarin-xaml-light-game

Step 13

In the Solution Explorer select the Expand arrow next to MainPage.xaml to open MainPage.cs, then select this from the Shared Project

xamarin-vs2017-library-mainpage-cs

Step 14

From the Menu choose View and then Open

xamarin-vs2017-view-open

Step 15

Once in the Code View, below the public MainPage() { … } the following Code should be entered:

Library library = new Library();

private void New_Clicked(object sender, EventArgs e)
{
	library.New(this, Display);
}

It should then appear as such:

xamarin-code-light-game

Step 16

That completes the application, so from the Menu choose Build and then Build Solution

xamarin-vs2017-build-solution

Step 17

Then from the Menu choose Debug then Start Debugging to run the Application in the Android Emulator

xamarin-vs2017-debug-start

Step 18

Once started the Application should then appear in the Android Emulator

xamarin-android-run-light-game

Step 19

After the Application has started running use New to start playing, you can win by setting all the White squares to Black

xamarin-android-ran-light-game

Step 20

To Exit the Application select Stop in Visual Studio

xamarin-vs2017-stop

Step 21

Another option is to run as a Universal Windows Application. From Solution Explorer select the Project ending with .UWP (Universal Windows), then from the Menu choose Project then Set as StartUp Project

xamarin-vs2017-project-startup

Step 22

Then again from the Menu choose Build and then select the Deploy option ending with .UWP

xamarin-vs2017-uwp-deploy

Step 23

Then once again from the Menu choose Debug then Start Debugging to run the Application in Windows 10

xamarin-vs2017-debug-start

Step 24

Once started the Application should then appear

xamarin-uwp-run-light-game

Step 25

After the Application has started running use New to start playing, you can win by setting all the White squares to Black

xamarin-uwp-ran-light-game

Step 26

To Exit the Application select Stop in Visual Studio

xamarin-vs2017-stop

Step 27

Also if you have Mac with the Xamarin tools installed and have enabled and connected to the Xamarin Mac Agent. From Solution Explorer select the Project ending with .iOS, then from the Menu choose Project then Set as StartUp Project

xamarin-vs2017-project-startup

Step 28

Then once again from the Menu choose Debug then Start Debugging to run the Application for iOS

xamarin-vs2017-debug-start

Step 29

Once started the Application should then appear

Screenshots provided by Julia Boichentsova

Step 30

After the Application has started running use New to start playing, you can win by setting all the White squares to Black

Screenshots provided by Julia Boichentsova

Step 31

To Exit the Application select Stop in Visual Studio

xamarin-vs2017-stop

Thanks for Julia Boichentsova for helping with iOS screenshots

Creative Commons License

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s