Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[6.5][Migration] Tutorial how to migrate Xamarin.Android to Tizen #1545

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions docs/application/dotnet/guides/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -224,6 +224,36 @@ Tizen.Wearable.CircularUI supports Tizen wearable-specific user interfaces and T
</div>
</div>
</div>
<div class="col col-md-3">
<div class="card card-infra card-list h-100">
<div class="card-body">
<p class="h3 card-title">Maigration to Xamarin.Tizen</p>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<p class="h3 card-title">Maigration to Xamarin.Tizen</p>
<p class="h3 card-title">Migration to Xamarin.Tizen</p>

<div class="card-text">
<ul class="list-infra list-infra-arrow">
<li><a href="migration/migrate-xaml-android.md">Migrate Xamarin.Android</a></li>
</ul>
</div>
</div>
<div class="card-footer">
<a class="link-standalone" href="migration/overview.md">Learn more</a>
</div>
</div>
</div>
<div class="col col-md-3">
<div class="card card-infra card-list h-100">
<div class="card-body">
<p class="h3 card-title">Migration to Xamarin.Tizen</p>
<div class="card-text">
<ul class="list-infra list-infra-arrow">
<li><a href="migration/migrate-xaml-forms.md">Migrate Xamarin.Forms</a></li>
</ul>
</div>
</div>
<div class="card-footer">
<a class="link-standalone" href="migration/overview.md">Learn more</a>
</div>
</div>
</div>
<div class="col col-md-3">
<div class="card card-infra card-list h-100">
<div class="card-body">
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Migrate Xamarin.Android App to Xamarin.Tizen
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't see any content in this page, @patrykka could you please check?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@patrykka kindly check this particular file


Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file still does not have information, and so cannot proceed further with this PR review.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@patrykka, is this file part of this PR

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I still don't see information included in this topic. Please check and add the required information.



## Related information
- Dependencies
- Tizen 6.5 and Higher
52 changes: 52 additions & 0 deletions docs/application/dotnet/guides/migration/migrate-xaml-forms.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# Migrate Xamarin.Forms App to NUI Xaml

The process for migrating a Xamarin.Forms app to Xmarin.Tizen is expected to be:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think some rephrasing required for this sentecne.

Suggested change
The process for migrating a Xamarin.Forms app to Xmarin.Tizen is expected to be:
The process for migrating a Xamarin.Forms app to Xmarin.Tizen performs the following:


1. Create empty NUI Xaml App
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Create empty NUI Xaml App
1. Create an empty NUI Xaml App.

2. Update namespaces and declared assemblies
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Update namespaces and declared assemblies
2. Update the namespaces and declared assemblies.

3. Convert elements
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. Convert elements
3. Convert the elements.

3. Build and fix any issues
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. Build and fix any issues
4. Build and fix any issues.

4. Run the converted app and verify that is functions correctly.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
4. Run the converted app and verify that is functions correctly.
5. Run the converted app and verify that it functions correctly.


## Migration process

### Create empty NUI Xaml App

Follow [Get-Started](../user-interface/nui/xaml/get-started-xaml.md) to create empty Tizen NUI XAML App
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Follow [Get-Started](../user-interface/nui/xaml/get-started-xaml.md) to create empty Tizen NUI XAML App
Follow [Get-Started](../user-interface/nui/xaml/get-started-xaml.md) to create empty Tizen NUI XAML App.


### Update namespaces and declared assembiles

| Old namespace and assembly | New namespace and assembly |
| ------------------------------------ | ---------------------------------------- |
| xmlns="http://zamarin.com/schemas/2014/forms | xmlns="http://tizen.org/Tizen.NUI/2018/XAML" |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Link in the new namespace column is broken. Please check and fix the issue.

| | xmlns:base="clr-namespace:Tizen.NUI.BaseComponets;assembly=Tizen.NUI" |
| | xmlns:comp="clr-namespace:Tizen.NUI.Componets;assembly=Tizen.NUI.Components" |
| xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" | xmlns:x="https://schemas.microsoft.com/winfx/2009/xaml" |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please check these links, since the target pages are not opening.


### Convert elements

Basing on sample app source code
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are we missing text in this sentence?

Suggested change
Basing on sample app source code
Based on sample app source code..........???


| Xamarin.Forms | Xmarin.Tizen |
| ------------- | ------------ |
|[XAML Forms Page](FormsXamlPage.xaml)|[XAML Tizen Page](TizenXamlPage.xaml) |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The hyperlinks are broken. Please check and fix the issue.


#### XAML Source

Below table shows UI elements form Xamarin.Forms and their replacement in NUI Xaml
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please check if following suggestion looks fine?

Suggested change
Below table shows UI elements form Xamarin.Forms and their replacement in NUI Xaml
The following table shows UI elements from Xamarin.Forms and their replacement in NUI Xaml:


| Xamarin.Forms | NUI Xaml |
| ------------- | ------------ |
| Frame | View |
| Label | TextLabel |
| FontSize | PointSize |

### Verification

| Xamarin.Forms | NUI Xaml |
| ------------- | ------------ |
|<img src="./xaml-forms.png" width="300"> | <img src="./xaml-tizen.png" width="300"> |

## Related information
- Dependencies
- Tizen 6.5 and Higher
14 changes: 14 additions & 0 deletions docs/application/dotnet/guides/migration/overview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# Migration

There is no need to rewrite your Xamarin.Forms and Xamarin.Andorid apps to run them on Tizen Platform.

Xamarin.Forms App you can load directly to VS and run on your device, while Xamarin.Android specific Apps needs some code changes.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Xamarin.Forms App you can load directly to VS and run on your device, while Xamarin.Android specific Apps needs some code changes.
Xamarin.Forms app you can load directly to VS and run on your device, while Xamarin.Android specific apps needs some code changes:


- [Migration Xamarin.Forms](migrate-xaml-forms.md)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [Migration Xamarin.Forms](migrate-xaml-forms.md)
- [Migrate Xamarin.Forms](migrate-xaml-forms.md)


- [Migrate Xamarin.Android](migrate-xaml-android.md)


## Related information
- Dependencies
- Tizen 6.5 and Higher
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 5 additions & 0 deletions docs/application/toc_all.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,11 @@
#### [Single Shot](/application/dotnet/guides/machine-learning/singleshot.md)
#### [Pipeline](/application/dotnet/guides/machine-learning/pipeline.md)

### Migration
#### [Overview](/application/dotnet/guides/migration/overview.md)
#### [Migrate Xamarin.Forms](/application/dotnet/guides/migration/migrate-xaml-forms.md)
#### [Migrate Xamarin.Android](/application/dotnet/guides/migration/migrate-xaml-android.md)

### Maps
#### [Overview](/application/dotnet/guides/maps/maps.md)
#### [Getting HERE Maps Credentials](/application/dotnet/guides/maps/here-credentials.md)
Expand Down