Skip to content

Commit c403587

Browse files
ebicogluebicoglu
committed
Xamarin docs revised
1 parent a2aa35b commit c403587

File tree

1 file changed

+37
-44
lines changed

1 file changed

+37
-44
lines changed

‎doc/Development-Guide-Xamarin.html

Lines changed: 37 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
1+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
22
<html xmlns="http://www.w3.org/1999/xhtml">
33

44
<head>
55
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
66
<link type="text/css" rel="stylesheet" href="bootstrap.min.css" />
7-
<title>Development Guide</title>
7+
<title>Xamarin Development Guide</title>
88
</head>
99

1010
<body>
@@ -21,15 +21,15 @@ <h3>Introduction</h3>
2121
<p>Xamarin is a cross-platform UI toolkit that allows developers to efficiently
2222
create native cross platform user interface layouts.<br>
2323
This document is intended to show how to setup a Xamarin development environment
24-
and introduce existing features, user interfaces on Asp.Net Zero Xamarin platform.<br>
24+
and introduce existing features and user interfaces on Asp.Net Zero Xamarin platform.
2525
For an overview of the Xamarin installation and setup practices see
2626
<a href="https://developer.xamarin.com/guides/xamarin-forms/getting-started/installation/">
2727
Xamarin.Forms Requirements</a> and
2828
<a href="https://developer.xamarin.com/guides/cross-platform/getting_started/installation/">
2929
Installation</a>. <br>
3030
For an overview of the Asp.Net Zero getting started see
31-
<a href="/Getting-Started-Core">Asp.Net Zero Getting Started.</a> The Asp.Net Zero
32-
Xamarin is only available for Asp.Net Core! (Angular UI or Mvc UI)</p>
31+
<a href="Getting-Started-Core">Asp.Net Zero Getting Started.</a> The Asp.Net Zero
32+
Xamarin is only available for Asp.Net Core included Angular UI and Mvc UI.</p>
3333
<h4>Prerequisites</h4>
3434
<p>Following tools are needed in order to develop ASP.NET Zero Xamarin:</p>
3535
<ul>
@@ -65,7 +65,7 @@ <h4>Android</h4>
6565
<img class="img-thumbnail" alt="Xamarin Android Options" src="images/options-android-vs-sml.png" />
6666
<h4>Mac System Requirements</h4>
6767
<p>You can use Visual Studio for Mac to develop Xamarin.Forms apps on OS X El Capitan
68-
(10.11) or newer. To develop iOS apps, it is recommended Having at least the iOS
68+
(10.11) or newer. To develop iOS apps, it is recommended having at least the iOS
6969
10 SDK and Xcode latest installed.</p>
7070
<h4>Windows System Requirements</h4>
7171
<p>Xamarin.Forms apps for iOS and Android can be built on any Windows installation
@@ -81,16 +81,17 @@ <h4>Solution Structure (Layers)</h4>
8181
</ul>
8282
<p>For Xamarin development, you can open <b>.Mobile.sln</b>.</p>
8383
<div class="image-container">
84-
<img class="img-thumbnail" alt="ASP.NET Zero Xamarin Architecture" src="images/xamarin-architecture.png" />
84+
85+
<img class="img-thumbnail" alt="ASP.NET Zero Xamarin Architecture" src="images/xamarin-architecture.png"/>
8586
<p>Xamarin Architecture</p>
8687
</div>
8788
<div class="image-container">
88-
<img class="img-thumbnail" alt="ASP.NET Zero Mobile Solution" src="images/mobile-solution-overview.png" />
89+
<img class="img-thumbnail" alt="ASP.NET Zero Mobile Solution" src="images/mobile-solution-overview.png"/>
8990
<p>Mobile Solution</p>
9091
</div>
9192
<p>There are 6 projects in the mobile solution:</p>
9293
<ul>
93-
<li><strong>Core.Shared</strong> project basic primitive types as consts, enums
94+
<li><strong>Core.Shared</strong> project contains basic primitive types like consts, enums that
9495
used in all layers of the solution.</li>
9596
<li><strong>Application.Shared</strong> project contains data transfer objects
9697
(DTOs) and interfaces of application services shared with application layer
@@ -114,9 +115,9 @@ <h4>Host</h4>
114115
dotnet run</pre>
115116
<p>In order to every time write these lines, you can download the batch file below
116117
and run it to host your web api.</p>
117-
<pre style="width:210px"><a href="etc/start-host.zip">Download start-host.zip</a></pre>
118+
<pre style="width:210px"><a href="https://github.com/aspnetzero/documents/tree/master/doc/etc/start-host.zip">Download start-host.zip</a></pre>
118119
<div class="bs-callout bs-callout-warning">
119-
<strong><i class="fa fa-warning"></i>Warning</strong>
120+
<strong><i class="fa fa-warning"></i> Warning</strong>
120121
<div>
121122
Before running the batch file, open it in notepad and replace the Web.Host
122123
or Web.Mvc directory path with yours!</div>
@@ -189,15 +190,15 @@ <h4>Debugging IOS</h4>
189190
<br>
190191
<br>
191192
<div class="bs-callout bs-callout-warning">
192-
<p><i class="fa fa-warning"></i><a href="https://www.xamarin.com/live/">Xamarin
193+
<p><i class="fa fa-warning"></i> <a href="https://www.xamarin.com/live/">Xamarin
193194
Live Player</a> currently does not support some of the key features. Thus Asp.Net
194195
Zero Xamarin application cannot be debugged on Xamarin Live Player. Further
195196
information read
196197
<a href="https://developer.xamarin.com/guides/cross-platform/live/limitations/">
197198
Xamarin Live Player limitations.</a></p>
198199
</div>
199200
<div class="bs-callout bs-callout-info">
200-
<p><i class="fa fa-info-circle"></i><a href="https://www.livexaml.com/">LiveXAML</a>
201+
<p><i class="fa fa-info-circle"></i> <a href="https://www.livexaml.com/">LiveXAML</a>
201202
is a Xaml previewer runs while you are debugging your application inside an
202203
emulator. Whenever you save any XAML file, it automatically updates the running
203204
application. If you want to purchase LiveXAML, Asp.Net Zero customers get %30
@@ -213,12 +214,12 @@ <h3>Xamarin.Forms</h3>
213214
<h4>Mobile.Droid</h4>
214215
<p>Xamarin Android project has a very basic structure. Asp.Net Zero adds or modifies
215216
these files in the default project; </p>
216-
<table width="100%" cellspacing="1">
217-
<tr valign="top">
218-
<td width="487">
219-
<img class="img-thumbnail" alt="Android Project Structure" src="images/xamarin-android-project-structure.png" />
220-
</td>
221-
<td>
217+
218+
<div class="image-container">
219+
<img class="img-thumbnail" alt="Android Project Structure" src="images/xamarin-android-project-structure.png" />
220+
<p>Android Project Structure</p>
221+
</div>
222+
222223
<ul>
223224
<li><strong>SplashActivity </strong>There are time consuming background
224225
operations while starting up like bootstrapping ABP, retrieving configuration
@@ -250,11 +251,9 @@ <h4>Mobile.Droid</h4>
250251
and Android cultures.</li>
251252
</ul>
252253
</div>
253-
</td>
254-
</tr>
255-
</table>
254+
256255
<div class="bs-callout bs-callout-info">
257-
<strong><i class="fa fa-info-circle"></i>Information</strong>
256+
<strong><i class="fa fa-info-circle"></i> Information</strong>
258257
<p>Asp.Net Zero Xamarin changed the output path (bin) and intermediate output
259258
path (obj) of Android project to be shorter. The main reason of this is avoiding
260259
&quot;Path too long&quot; exceptions while compiling project. If you want to modify it,
@@ -265,12 +264,12 @@ <h4>Mobile.Droid</h4>
265264
<h4>Mobile.iOS</h4>
266265
<p>Xamarin IOS project has a very simple structure. Asp.Net Zero adds or modifies
267266
these files in the default project; </p>
268-
<table width="100%" cellspacing="1">
269-
<tr valign="top">
270-
<td width="306">
267+
268+
<div class="image-container">
271269
<img class="img-thumbnail" alt="IOS Structure" src="images/xamarin-ios-project-structure.png" />
272-
</td>
273-
<td>
270+
<p>IOS Structure</p>
271+
</div>
272+
274273
<ul>
275274
<li><strong>Locale </strong>This class is an adapter between .Net cultures
276275
and IOS cultures.</li>
@@ -287,9 +286,7 @@ <h4>Mobile.iOS</h4>
287286
all the Icon*.png and Default*.png files files with yours based on the
288287
same sizes.</li>
289288
</ul>
290-
</td>
291-
</tr>
292-
</table>
289+
293290
<h4>Mobile.Shared</h4>
294291
<p>Shared project is a special type of project that can be used across disparate
295292
CLI platforms including Mobile.iOS and Mobile.Android. That&#39;s why it&#39;s not been
@@ -304,14 +301,15 @@ <h4>Mobile.Shared</h4>
304301
Setting Up A Xamarin Cross Platform Solution</a></div>
305302
</div>
306303
<h5>Project structure</h5>
307-
<table width="100%" cellspacing="1">
308-
<tr valign="top">
309-
<td width="306">
304+
<div class="image-container">
310305
<img class="img-thumbnail" alt="Shared Project Structure" src="images/xamarin-shared-project-structure.png" />
311-
</td>
312-
<td style="padding-left:10px">Mobile.Shared project consists of fundamentals
306+
<p>Shared Project Structure</p>
307+
</div>
308+
309+
<p>Mobile.Shared project consists of fundamentals
313310
of a Xamarin application like Behaviors, Commands, Controls, Converters,
314-
Extensions,Views and ViewModels.
311+
Extensions,Views and ViewModels.</p>
312+
315313
<h6>MVVM</h6>
316314
<p>The Model-View-ViewModel (MVVM) architectural pattern was used in the
317315
shared project. The pattern enforces a separation between three software
@@ -334,10 +332,7 @@ <h6>MVVM</h6>
334332
...
335333
<span style="background-color: #FFFF00">base:ViewManager.AutoWireViewModel=&quot;true&quot;</span>
336334
...&gt;</pre>
337-
</td>
338-
</tr>
339-
<tr valign="top">
340-
<td colspan="2">
335+
341336
<h6>Dependency Injection</h6>
342337
<p>Asp.Net Zero Xamarin uses Asp.Net Boilerplate framework dependency injection
343338
system. Hence it uses
@@ -507,9 +502,7 @@ <h6>ProfilePictureView</h6>
507502
<p>This is for viewing user profile picture in full screen mode. When user
508503
taps the thumb profile image on top of the navigation menu, this view is
509504
shown.</p>
510-
</td>
511-
</tr>
512-
</table>
505+
513506
<h3>Distribution</h3>
514507
<h4>Configuration</h4>
515508
<ul>

0 commit comments

Comments
 (0)