{"id":18829066,"url":"https://github.com/amay077/xammaterialtodo","last_synced_at":"2026-03-14T01:47:14.754Z","repository":{"id":138393655,"uuid":"187324047","full_name":"amay077/XamMaterialTodo","owner":"amay077","description":"Xamarin.Forms Visual によるマテリアルな iOS/Android アプリのサンプル","archived":false,"fork":false,"pushed_at":"2023-02-24T16:29:22.000Z","size":1611,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-27T17:22:05.093Z","etag":null,"topics":["android","csharp","decode2019","ios","material-design","xamarin","xamarin-forms"],"latest_commit_sha":null,"homepage":"https://www.microsoft.com/ja-jp/events/decode/2019/default.aspx","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amay077.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-18T06:45:17.000Z","updated_at":"2020-01-21T03:56:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"e1456b2e-4e6d-4228-80d1-5469c9940856","html_url":"https://github.com/amay077/XamMaterialTodo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amay077%2FXamMaterialTodo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amay077%2FXamMaterialTodo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amay077%2FXamMaterialTodo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amay077%2FXamMaterialTodo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amay077","download_url":"https://codeload.github.com/amay077/XamMaterialTodo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248814380,"owners_count":21165756,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","csharp","decode2019","ios","material-design","xamarin","xamarin-forms"],"created_at":"2024-11-08T01:39:49.252Z","updated_at":"2026-03-14T01:47:14.721Z","avatar_url":"https://github.com/amay077.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"Xamarin.Forms Visual によるマテリアルな iOS/Android アプリのサンプル\n----\n\n## これは何？\n\nこのリポジトリは、2019年5月29〜30日に東京で開催された 「[de:code 2019](https://www.microsoft.com/ja-jp/events/decode/2019/default.aspx)」のセッション「[MW03: Xamarin.Forms アプリケーション設計パターン](https://www.microsoft.com/ja-jp/events/decode/2019session/detail.aspx?sid=MW03)」 に対応するサンプルコードと解説です。\n\nXamarin.Forms 3.6 で **Xamarin.Forms Visual** という機能が追加されました。\n\n* [Beautiful Material Design for Android \u0026 iOS | Xamarin Blog](https://devblogs.microsoft.com/xamarin/beautiful-material-design-android-ios/)\n* [Xamarin.Forms Visual - Xamarin | Microsoft Docs](https://docs.microsoft.com/en-us/xamarin/xamarin-forms/user-interface/visual/)\n\nこれは Xamarin.Forms Visual を使用して Material デザインを適用した Android/iOS 向けのサンプルアプリケーションです。\n\n## Xamarin.Forms Visual とは何か？\n\nXamarin.Forms Visual は、 ``ContentPage`` や各UIパーツに存在する ``Visual`` プロパティに定義された値を指定することによって、そのUIパーツの **見た目や挙動を切り替える** 機能です。\n\n公式で用意された、Visual プロパティへ設定可能な値には、\n\n* ``Default`` \n* ``MatchParent``\n* ``Material``\n\nがあり、[Material](https://docs.microsoft.com/en-us/xamarin/xamarin-forms/user-interface/visual/material-visual) は、Visual への設定値の一つです。\n\n``Page`` や各種View の ``Visual`` プロパティに ``Material`` を設定することで、対応したUIパーツが Material デザインになります。\n\nVisual の実態は Custom Renderer であり、``Material`` と設定された場合には、[Material 用の Custom Renderer](https://docs.microsoft.com/en-us/xamarin/xamarin-forms/user-interface/visual/material-visual#customize-material-renderers) が動作し、Material デザインのような見た目と挙動を実現しています。\n\n見た目だけを切り替えるのであれば [Themes](https://docs.microsoft.com/en-us/xamarin/xamarin-forms/user-interface/themes/) や [Styles](https://docs.microsoft.com/en-us/xamarin/xamarin-forms/user-interface/styles/) という機能が既に存在していますが、「挙動」も含めた柔軟な UI の変更が求められる場合には Visual を使用すべきです。\n\n## 必要な環境\n\n### 開発環境\n\n* Windows - Visual Studio 2017 または 2019\n* macOS - Visual Studio for Mac ver 8.0.5 (作者はこちらを使用しています)\n\n### 実行環境\n\n* Android - Android 5.0 以降の実機端末またはエミュレータ\n* iOS - iOS 8.0 以降の実機端末またはシミュレータ\n\n※UWP には対応していません。\n\n## 実行(ビルド)方法\n\nVisual Studio 2017/2019 または Visual Studio for Mac で ``XamMaterialTodo.sln`` ファイルを開き、実機またはエミュレータをデプロイ先に選択して実行してください。\n\n## どんなサンプルアプリ？\n\nさて、この Visual Material に触れるサンプルとして用意したのが、簡単な ToDo アプリケーションです。\n\n### メイン画面\n\n![](screenshots/image01.png)\n\n* ToDo の一覧画面で、上から優先順位の高い順、期限の近い順に表示されます\n* 右上のボタンで、完了した ToDo を隠すかどうかを切り替えられます\n* 右下のボタンで、新しい ToDo を追加できます\n\n### メイン画面(コンテキストメニュー)\n\n![](screenshots/image02.png)\n\n* iOS ではスワイプ、Android では長押しでコンテキストメニューが表示でき、ToDo の削除と未完了に戻す事ができます。\n\n### ToDo 詳細画面\n\n![](screenshots/image03.png)\n\n* ToDo のタイトル、期日、優先順位、詳細が登録できます\n* 右下のボタンで ToDo を「完了」にできます\n\n## Xamarin.Forms における Material デザイン適用の実際\n\nアプリに簡単にマテリアルデザインを適用できる、という触れ込みの Xamarin.Forms Visual Material ですが、実際には満足が行く程度にまでマテリアルな見た目にするには、アプリケーションでの実装を「がんばる」必要があります。\n\nこのサンプルアプリケーションも、「そんなにマテリアルか？」と言われると「…はい」としか答えられないです。。。\n\nそれは、現在対応 Material にしているUIパーツは以下の11個(*付きはサンプルアプリで使用しています)だけであり、これらだけでは「Material なアプリ」を作ることは難しいためです。\n\n* Button\n* Entry(*)\n* Frame(*)\n* ProgressBar\n* DatePicker(*)\n* TimePicker\n* Picker\n* ActivityIndicator\n* Editor(*)\n* Slider(*)\n* Stepper\n\n[Material Design](https://material.io/design/) 公式で提示されている Components や、マテリアルデザインの提供者である Google が開発しているクロスプラットフォームアプリ開発ツール [Flutter の Material Widgets](https://flutter.dev/docs/development/ui/widgets/material) と比較すると、パーツの数も再現度も貧弱と言わざるを得ません。\n\n### 対応されていないUI部品は？\n\nCustom Renderer を自作するか、既存の部品を組み合わせてそれっぽく見せるしかないです。\n\n例えば、[FAB(Floating Action Button)](https://material.io/design/components/buttons-floating-action-button.html) は、このサンプルでは、ただの丸い ``ImageButton`` です。\n\n```xaml:\n\u003cImageButton Grid.Column=\"1\" Grid.Row=\"1\"\n    Source=\"https://raw.githubusercontent.com/amay077/XamMaterialTodo/master/img/baseline_add_white_48dp.png\"\n    BackgroundColor=\"#2B78FE\" \n    Padding=\"10\" CornerRadius=\"25\" \n    WidthRequest=\"50\" HeightRequest=\"50\"  \n    VerticalOptions=\"Center\" HorizontalOptions=\"Center\"\n    Command=\"{Binding AddCommand}\"/\u003e\n```\n\n「もっと Material デザインにしたい！」という方は、2019年3月末に Xamarin チームが「Xamarin Visual Challenge」というオンラインイベントを行っていました。著名なアプリのデザインを Xamarin Forms を使って再現してみよう、という趣旨で、その結果を GitHub のリポジトリで見ることができます。\n\n* [Join the Xamarin Visual Challenge | Xamarin Blog](https://devblogs.microsoft.com/xamarin/join-the-xamarin-visual-challenge/)\n* [Visual Challenge Conquered! | Xamarin Blog](https://devblogs.microsoft.com/xamarin/visual-challenge-conquered/)\n* [Pull Requests · davidortinau/VisualChallenge](https://github.com/davidortinau/VisualChallenge/pulls)\n\n投稿された Pull Requests を見てみると、どのようにして Material デザインを再現したかが分かりますので、参考にしてみてください。私は「皆さん、自力で頑張ってるなあ」という感想を持ちました(Visual Material あまり関係なくない？ともw)。\n\n## その他 Xamarin.Forms 新機能の Tips\n\n### Visual と Shell\n\n2019年5月29日に Xamarin.Forms 4.0 がリリースされ、Shell という機能が公式に提供されました。\n\n* [Welcome to the Shell Era: Xamarin.Forms 4.0 Released | Xamarin Blog](https://devblogs.microsoft.com/xamarin/introducing-xamarin-forms-4-0-the-era-of-shell/)\n* [Xamarin.Forms Shell - Xamarin | Microsoft Docs](https://docs.microsoft.com/en-us/xamarin/xamarin-forms/app-fundamentals/shell/)\n\nShell とは、スマホアプリでよく使用される画面パターンをフレームワークとして提供し、その画面パターンが適用できるのであれば高速に「モダンな」アプリが開発できる、というものです。\n\nVisual とは直接関係はなく、Shell のソリューションテンプレートでも Visual は使用されていませんが、Shell と Visual を併用すると、「より Material でモダンな」アプリが作りやすいものと思います。例えば、このサンプルアプリの iOS 版はヘッダが白い背景色ままですが、Shell で作ったアプリの iOS 版は、Android 版と同じくヘッダが青い背景色になります。\n\n### Fontアイコンの使用と Image Source Unification\n\nXamarin.Forms 3.5 で ``FontImageSource`` が導入され、 [FontAwesome](https://fontawesome.com/) や [Material Design Icons](https://materialdesignicons.com/) が利用しやすくなりました。\nXamarin.Forms 4.0 では、あらゆるコントロールですべての ImageSource が使用できるようになりました。\n例えば ``Button.Image`` プロパティは、これまでは ``FileImageSource`` であったために、``FontImageSource``, ``UriImageSource`` などは使用できませんでしたが、Xamarin.Forms 4.0 からはすべて使用できます。\n\nこのサンプルアプリでも、アイコンは Material Design Icons と ``FontImageSource`` を使用しています。\n\n```xaml:\n\u003cImageButton Grid.Column=\"1\" Grid.Row=\"1\"\n    x:Name=\"btn\"\n    BackgroundColor=\"#2B78FE\" \n    Padding=\"10\" CornerRadius=\"25\" \n    WidthRequest=\"50\" HeightRequest=\"50\"  \n    VerticalOptions=\"Center\" HorizontalOptions=\"Center\"\n    Command=\"{Binding AddCommand}\"\u003e\n    \u003cImageButton.Source\u003e\n        \u003cFontImageSource\n            FontFamily=\"{DynamicResource MaterialFontFamily}\"\n            Glyph=\"{StaticResource plus}\" /\u003e\n    \u003c/ImageButton.Source\u003e                \n\u003c/ImageButton\u003e\n```\n\nWebFont(``.ttf``)をプロジェクトへ追加する方法は、\n\n* [Simple way to use icon fonts in Xamarin Forms projects – Trailhead Technology Partners](https://trailheadtechnology.com/simple-way-to-use-icon-fonts-in-xamarin-forms-projects/)\n\n、``FontImageSource`` の使い方については、\n\n* [Using Font Icons in Xamarin.Forms: Goodbye Images, Hello Fonts! - James Montemagno](https://montemagno.com/using-font-icons-in-xamarin-forms-goodbye-images-hello-fonts/)\n\nが、それぞれ詳しいです。このサンプルと合わせてご覧ください。\n\n## サンプルアプリの設計\n\nここからは Visual Material に関係のない、GUI アプリケーション設計の話です。\n\nこのサンプルアプリケーションは MVVM パターンを採用しています。DDD や Clean Archtecture から「Usecase」や「Repository」という概念も採用しています。\n\nde:code で発表された @runceel さんによる登壇内容(以下に詳細解説あり)と、大筋では変わらない設計になっているので、参考にしていただければ幸いです。\n\n* [de:code 2019 Xamarin.Forms アプリケーション設計パターン の登壇内容解説 - Microsoft Tech Community](https://techcommunity.microsoft.com/t5/Windows-Dev-AppConsult/de-code-2019-Xamarin-Forms-%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E8%A8%AD%E8%A8%88%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3-%E3%81%AE%E7%99%BB%E5%A3%87%E5%86%85%E5%AE%B9%E8%A7%A3%E8%AA%AC/ba-p/662345)\n\n尚、プラットフォーム側での固有処理は行っておらず、共通の XamMaterialTodo プロジェクトですべての実装を行っています。\n\nXamMaterialTodo プロジェクトのクラス図は以下のようになっています。\n\n![](screenshots/image04.png)\n\n\nまた、ディレクトリ(名前空間)構成は以下のようになっています。\n\n```\n/XamMaterialTodo\n ├/DataModels\n ├/Repositories\n ├/Usecases\n └/Presentations\n   ├/Main\n   └/Detail\n```\n\n### DataModels 名前空間\n\nプロジェクト共通で使用するデータクラスが含まれています。今回は一つの ToDo を表す ``TodoItem`` のみが含まれ、あらゆる箇所で使用されます。\n\n### Repositories 名前空間\n\nデータストアから ``TodoItem`` 読み出し、または保存する Interface 定義とその実装クラスを含みます。\n\n今回はデータストアに LiteDB を採用しました。\n\n* [LiteDB :: A .NET embedded NoSQL database](https://www.litedb.org/)\n\n端末内のデータストアといえばまずは SQLite が想定されると思いますが、SQLite はテーブルを設計・作成したり、データのI/Oのために SQL を記述する必要があるなどの面倒さがあります。\nLiteDB は、MogoDB のようなドキュメント指向の NoSQL で、データクラスである ``TodoItem`` をそのまま扱える利点があります。またすべて C# で実装されていて依存ライブラリが少なく、導入も簡単です。\n\nLiteDB に対してのデータIOは ``LiteDbTodoRepository`` として実装されています。\n\nもし、SQLite, [Firebase Firestore](https://firebase.google.com/docs/firestore/), [AppCenter Data](https://docs.microsoft.com/en-us/appcenter/data/) といった他のデータストアに対応したい場合は、 ``ITodoRepository`` インターフェースを実装して新しいリポジトリクラスを作成し、``LiteDbTodoRepository`` と差し替えるだけです。\n\n### Usecases 名前空間\n\nこの層にはToDoアプリについてのビジネスロジックを実装したクラスが含まれます。\n今回は機能の少ない単純なアプリであるため、``TodoUsecase`` クラスが一つだけあり、「ToDo の追加や削除」、「ToDo の完了」、「未完了または全ての ToDo 一覧の取得」などの機能が実装されています。もちろんその実装には ``ITodoRepository`` が使用されています。 \n\n### Presentations 名前空間\n\nこの層には、いわゆる MVVM の V(View) と VM(ViewModel) が含まれます。\n\nサブディレクトリ ``Main`` は ToDo 一覧画面、 ``Detail`` が ToDo 詳細画面を示し、それぞれのディレクトリに画面を示す ``Page`` クラスと、 ``ViewModel`` クラスが含まれます。多くの人は ``Viws`` と ``ViewModels`` でディレクトリや名前空間を分けると思いますが、View と ViewModel はペアで密結合しているため、画面ごとにディレクトリを分けてみました。[^1]\n\n[^1]: これは [DroidKaigi2019 アプリの構成](https://github.com/DroidKaigi/conference-app-2019) を参考にしています。\n\n#### ReactiveProperty と Reactive Extensions\n\nPage とのデータバインディングに必要な ViewModel の INotifyPropertyChanged の実装は [ReactiveProperty](https://github.com/runceel/ReactiveProperty) を採用しています。\n\nReactive Extensions については、使い倒してはいませんが、``DetailPageViewModel`` にていずれかの入力項目が変化した時、「変更されたバージョンの ``TodoItem`` を作り直す」という処理で活用しています。\n\n```csharp:\n// いずれかの項目が変化したら TodoItem を作り直す\nUpdatedItem = Observable.CombineLatest(\n    Title, Description, Priority, HasDueDate, DueDate,\n    (title, description, priority, hasDueDate, dueDate) =\u003e\n        new TodoItem(item.Id, title, IsDone.Value, description, priority, \n            hasDueDate ? dueDate : (DateTimeOffset?)null, item.CreateDate))\n    .ToReadOnlyReactiveProperty();\n```\n\n\n## 参考にしない方がよい点\n\nコピペだけで作ると後で痛い目を見るかも、という点を挙げてみました。\n\n### 画面遷移\n\nViewModel から画面遷移を行う方法は、今回は、\n\n1. ViewModel で画面遷移リクエストイベントを発生\n2. Page でそれを受信して画面遷移\n\nという方法を採用していますが、中〜大規模なアプリケーションな場合は、Prism などのフレームワークを使ってその仕組みに従った方が良いです。\n\n### リソース解放処理\n\n* 上記の画面繊維で、Page でのイベント受信 (``MainPage.xaml.cs`` など)\n* ViewModel 内での、 ``IObservable`` の ``Subscribe`` (``DetailViewModel.cs`` など)\n\nこれらの箇所では、イベントの ``-=`` での登録解除や、``Subscribe()`` の戻り値である ``IDisposable`` の ``.Dispose()`` を呼ぶべきかについて、注意を払う必要があります。\n\n### ReactiveProperty について\n\n``TodoUsecase`` では、 ``ReactiveProperty\u003cT\u003e`` よりも ``ReactivePropertySlim\u003cT\u003e`` を使用した方が良いでしょう。xxxSlim の方が、シンプルで軽量です（[ReactivePropertySlim詳解 - neue cc](http://neue.cc/2018/01/18_562.html)）。\n\n## ストレスの少ない画面開発(HotReload)について\n\nFlutter や React の開発ツールは、コードを変更すると実行中のアプリケーションにすぐにそれが適用される、いわゆる「HotReload」という仕組みが用意されています。\n\n一方、Xamarin では、Visual Studio に搭載されている \"XAML Previewer\" を通常は使用します。\n\n* [XAML Previewer for Xamarin.Forms - Xamarin | Microsoft Docs](https://docs.microsoft.com/en-us/xamarin/xamarin-forms/xaml/xaml-previewer/?pivots=windows)\n\nしかし XAML Previewer は Android や iOS の画面をシミュレートしているため、プラットフォームに依存したUI部品は描画されなかったり、Previewer 自体が機能しなくなったりとあまりストレスの軽減になっていないと個人的には感じます。\n\nこのサンプルでは、Xamarin.Forms でも HotReload を実現する LiveXAML というツールに必要な(nuget)ライブラリを同梱しています。\n\n* [LiveXAML for Xamarin Forms](https://www.livexaml.com/)\n* [Xamarin.Forms でも HotReload がしたい！ - Qiita](https://qiita.com/amay077/items/150f484e68924468a2c3)\n\nVisual Studio に LiveXAML の拡張機能をインストールして、アプリを実行すると、``xxx.xaml`` を変更して保存すればすぐに実行中のアプリに反映されます。有償ツールですがトライアル期間があり、それが切れても xaml ファイルが3つまでなら使用できますので、よければ試してみてください。私は LiveXAML で、画面開発の快適度が格段に上がりました。\n\n## ライセンス\n\nSee [LICENSE](LICENSE)\n\n## ご質問など\n\nこのサンプルについての質問は [Issues](https://github.com/amay077/XamMaterialTodo/issues) へ、不具合の修正やその他ご指摘などは [Pull request](https://github.com/amay077/XamMaterialTodo/pulls) をお送りください。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famay077%2Fxammaterialtodo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famay077%2Fxammaterialtodo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famay077%2Fxammaterialtodo/lists"}