<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Pei-chi on Medium]]></title>
        <description><![CDATA[Stories by Pei-chi on Medium]]></description>
        <link>https://medium.com/@peichi?source=rss-6727edfba6fc------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*OWuNpzMeuRRJ4UMNedUZag.jpeg</url>
            <title>Stories by Pei-chi on Medium</title>
            <link>https://medium.com/@peichi?source=rss-6727edfba6fc------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 16:31:29 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@peichi/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Flutter HW#09 — food map]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/flutter-hw-09-food-map-1cfdc69fb3c9?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/1cfdc69fb3c9</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Wed, 11 Sep 2024 03:47:02 GMT</pubDate>
            <atom:updated>2024-09-11T08:30:58.723Z</atom:updated>
            <content:encoded><![CDATA[<h3>Flutter HW#09 — food map</h3><p>練習：網路 API 串接、解析 JSON 資料、urlLauncher、Dialogue、InteractiveViewer、showModalBottomSheet、更改 App 顯示名稱與圖標</p><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84%E8%A9%A6%E7%85%89-%E5%8B%87%E8%80%85%E7%9A%84-100-%E9%81%93-swift-ios-app-%E8%AC%8E%E9%A1%8C/19-%E4%B8%B2%E6%8E%A5%E7%AC%AC%E4%B8%89%E6%96%B9-api-%E8%A7%A3%E6%9E%90-json-%E8%B3%87%E6%96%99%E9%A1%AF%E7%A4%BA-f1556e84daec">#19 串接第三方 API，解析 JSON 資料，轉換成自訂型別顯示</a></p><pre>目錄<br><br>  <a href="http://cb1d/">App 展示</a><br>     網頁連結 <br><br>  <a href="http://0185">基本架構</a>  <br>  頁面拆解 + 學習筆記  <br>     <a href="http://819c/">🐾 解析 JSON</a>  <br>        <a href="http://d0aa/">﹡factory</a><br>     <a href="http://a1da/">🐾 網路讀取</a> <br>     <a href="http://4ae5/">🐾 urlLauncher</a> <br>        <a href="http://28d0/">﹡Future</a><br>     <a href="http://2cc4/">🐾 Dialogue</a> <br>     <a href="http://008d/">🐾InteractiveViewer</a> <br>     <a href="http://7e0c/">🐾showModalBottomSheet</a> <br>     <a href="http://a283/">🐾更改 App 顯示名稱與圖標</a> <br>    <br>  <a href="http://ea72/">Resources</a>  <br>  <a href="http://822c/">Github 連結</a></pre><h3>App 展示</h3><p>＊因為有設置手指縮放圖片功能，iOS模擬器要加按 option 不太順滑，就乾脆用 chrome 模擬器錄製啦！</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/502/1*LLfUpbzUmM4hJuSjGaD8Zg.gif" /></figure><h4>網頁連結</h4><p><a href="https://pei-7.github.io/pei_food_map/">https://pei-7.github.io/pei_food_map/</a></p><p>＊p.s. 首頁的圖片因為是用網路上的照片放大裁切使用，有點模糊… 下次如果有去現場拍高清照片再更新吧🤣</p><h3>基本架構</h3><p>首頁：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ekhUPjd_y34rcowTwQr7nw.png" /></figure><p>餐廳列表頁：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3QpOmeXj8vF_ET4dm-bDSQ.png" /></figure><h3>頁面拆解 + 學習筆記</h3><p>這次就偷個懶，直接把頁面程式碼與學習筆記放一起啦：</p><h4>🐾 解析 JSON</h4><p><a href="https://dartpad.dev/?id=456fdc3aae0f519f8fe1398fb175ea14">DartPad</a></p><p>我要串接的資料是利用 Airtable 所建立的資料庫，在 Airtable 表格頁面右上角 “help” 可以找到 “API documentation”，裡面會有 API 串接方式與說明：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*H8b4sYRrt3DzoqAwiFsfUA.png" /></figure><p>表格轉換為 JSON 格式如下：</p><pre>{<br>  &quot;records&quot;: [<br>    {<br>      &quot;id&quot;: &quot;recCl4NrAio0KEi9m&quot;,<br>      &quot;createdTime&quot;: &quot;2024-09-05T07:40:24.000Z&quot;,<br>      &quot;fields&quot;: {<br>        &quot;restaurant_link&quot;: &quot;https://www.google.com/maps/place/xxxx&quot;,<br>        &quot;restaurant_name_chi&quot;: &quot;山河魯肉飯&quot;,<br>        &quot;imageLink&quot;: &quot;https://i.imgur.com/jjtGMSb.png&quot;,<br>        &quot;notes&quot;: &quot;᭼ Awarded four-star LOHAS stalls nationwide.\n\n᭼ Top recommendation if you&#39;d like to try a combination of braised pork rice and jute soup.\n&quot;,<br>        &quot;restaurant_name_eng&quot;: &quot;Shan-he braised pork rice&quot;,<br>        &quot;hashTag&quot;: [<br>          &quot;Braised pork rice&quot;,<br>          &quot;Jute soup&quot;<br>        ],<br>      }<br>    },<br>    ......<br>  ],<br>}</pre><p>手動設置將 JSON 轉換成自訂型別：<br>（參考彼得潘課堂範例：<a href="https://dartpad.dev/?id=456fdc3aae0f519f8fe1398fb175ea14">多層的 JSON 範例</a>）</p><pre>class Restaurant {<br>  //屬性：<br>  final String restaurantNameChi;<br>  final String restaurantNameEng;<br>  final String restaurantLink;<br>  final String notes;<br>  final List hashTag;<br>  final String imageLink;<br><br>  //創建：<br>  const Restaurant({<br>    required this.restaurantNameChi,<br>    required this.restaurantNameEng,<br>    required this.restaurantLink,<br>    required this.notes,<br>    required this.hashTag,<br>    required this.imageLink,<br>  });<br><br>  //使用 factory 構造函數<br>  factory Restaurant.fromJson(Map&lt;String, dynamic&gt; json) { //fromJson 是一個 factory 構造函數，用於從 JSON 數據創建 Restaurant 類的實例。<br>    Map fields = json[&#39;fields&#39;]; //從 JSON 中提取出 fields 對應的 value<br>    return Restaurant( //將 fields 內部的 key value 轉化成 Restaurant 實例<br>      restaurantNameChi: fields[&#39;restaurant_name_chi&#39;],<br>      restaurantNameEng: fields[&#39;restaurant_name_eng&#39;],<br>      restaurantLink: fields[&#39;restaurant_link&#39;],<br>      notes: fields[&#39;notes&#39;],<br>      hashTag: List&lt;String&gt;.from(fields[&#39;hashTag&#39;]), //hashTag 是一組 String<br>      imageLink: fields[&#39;imageLink&#39;],<br>    );<br>  }<br>}</pre><p><strong>＊factory：</strong></p><p>在 Dart 中，factory構造函數是一種特殊的構造函數，可以根據特定的邏輯來創建對象。我們可以選擇返回新的實例或已經存在的實例，甚至根據條件返回不同的類型或不同的實例。</p><p><strong>&gt; 定義 factory 構造函數：</strong></p><pre>class Person {<br>  final String name;<br>  final int age;<br>  Person(this.name, this.age);<br><br>  // factory 構造函數<br>  factory Person.sort(String name, int age) {<br>    if (age &lt; 18) { // 根據條件返回 Minor 實例<br>      return Minor(name, age);<br>    } else { // 根據條件返回 Adult 實例<br>      return Adult(name, age);<br>    }<br>  }<br>}<br><br>//Minor<br>class Minor extends Person { <br>  Minor(String name, int age) : super(name, age);<br><br>  @override<br>  String toString() =&gt; &#39;Minor: $name, $age years old&#39;;<br>}<br><br>//Adult<br>class Adult extends Person { <br>  Adult(String name, int age) : super(name, age);<br><br>  @override<br>  String toString() =&gt; &#39;Adult: $name, $age years old&#39;;<br>}<br></pre><p><strong>&gt; 呼叫 factory 構造函數：</strong></p><pre>void main() {<br>  var people1 = Person.sort(&#39;John Doe&#39;, 30);<br>  var people2 = Person.sort(&#39;Jane Doe&#39;, 15);<br><br>  print(people1); // Output: Adult: John Doe, 30 years old<br>  print(people2); // Output: Minor: Jane Doe, 15 years old<br>}</pre><h4>🐾 網路讀取</h4><p>這一段是照著彼得潘的課堂範例 &amp; Flutter 教學文件寫的。其實一開始也不太懂，但是照著一步步寫下來，大致上就理解每一步驟的用意了😆</p><p><a href="https://docs.flutter.dev/cookbook/networking/fetch-data">Fetch data from the internet</a></p><p><strong>&gt; 添加 http 套件</strong></p><p>在 terminal 輸入以下指令：</p><pre>flutter pub add http</pre><p>在要使用的頁面 import 套件：</p><pre>import &#39;package:http/http.dart&#39; as http;</pre><p><strong>&gt; 設置 State 裡會變動的參數與 setState() function</strong></p><pre>class ListPage extends StatefulWidget {<br>  final Cuisine cuisine; //自己設置的料理 Class。在這一頁會顯示出所有提供這道料理的餐廳。<br><br>  const ListPage({<br>    super.key,<br>    required this.cuisine,<br>  });<br><br>  @override<br>  State&lt;ListPage&gt; createState() =&gt; _ListPageState();<br>}<br><br>class _ListPageState extends State&lt;ListPage&gt; { <br><br>  //設置會變動的參數<br>  List _restaurantList = []; //如果從網路讀取到餐廳列表，則存在這個 List 中<br>  String? _errorText; //如果讀取失敗，則將錯誤訊息存到此字串<br>  bool _isLoading = true; //初始預設狀態為 &quot;讀取中&quot;、待讀取完成後設為 false (讀取結束)<br><br>  //setState()<br>  void updateState({List items = const [], String? errorText}) {<br>    setState(() {<br>      _restaurantList = items; //更新餐廳列表<br>      _errorText = errorText; //如果有收到錯誤訊息的話，更新錯誤字串(可為 null)<br>      _isLoading = false; //表示讀取完成<br>    });<br>  }</pre><p><strong>&gt; 顯示初始畫面</strong></p><pre>//在 initState 中先抓取網路資料以作為畫面顯示：<br>  @override<br>  void initState() {<br>    super.initState();<br>    fetchList(); //抓取網路資料的 function，完整程式碼如下 ↓<br>  }<br><br><br>  void fetchList() async { //使用 async 使其他程式仍可多線進行<br>    var response = await http.get( //使用 await 使此線等待 http 抓取到資料再繼續往下跑<br>        Uri.parse(<br>            &#39;https://api.airtable.com/v0/appqNvg0QhjEh4fwr/Restaurant%20List?&amp;view=Grid%20view&#39;),<br>        headers: { //使用 airtable api 需要 token 認證，在 headers 這邊輸入<br>          &#39;Authorization&#39;:<br>              &#39;Bearer my_token&#39;<br>        });<br>    try {<br>      if (response.statusCode == 200) { //如果讀取成功<br><br>        Map fetchedData = jsonDecode(response.body); //取得讀取到的資料<br>        List records = fetchedData[&#39;records&#39;]; //因為 Airtable 的資料外包了一層 [&#39;records&#39;]，這邊先直接用字串 key 直接讀取其 value<br>        List&lt;Restaurant&gt; restaurants =<br>            records.map((element) =&gt; Restaurant.fromJson(element)).toList(); //使用之前設置的 factory 構造將 records 內的資料轉換為 Restauratn 實例<br><br>        List&lt;Restaurant&gt; filteredRestaurants = restaurants.where((record) { //先判別該 Restaurant 是否有提供這道料理，有的話再列出<br>          List hashTags = record.hashTag; //該餐廳提供的菜色<br>          return hashTags.contains(widget.cuisine.englishName); //是否有包含這個頁面的料理<br>        }).toList();<br><br>        setState(() {<br>          updateState(items: filteredRestaurants);//更新 restaurantList<br>        });<br>      } else { //如果伺服器未成功回應<br>        setState(() {<br>          updateState(errorText: &#39;Failed to load items&#39;);<br>        });<br>      }<br>    } catch (e) {  //程式碼執行過程中的錯誤（例如資料解析錯誤或網路異常）<br>        setState(() {<br>          updateState(errorText: &#39;error: $e&#39;); <br>        });<br>    }<br>  }</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ui-jvA6hqau8JNgh3-U_Zw.png" /><figcaption>Airtable 的 API 串接說明</figcaption></figure><p><strong>&gt; 設置畫面</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*H1OfSp55bYVygt1p6SjhNw.png" /></figure><pre> @override<br>  Widget build(BuildContext context) {<br>    return Scaffold(<br>      appBar: AppBar(<br>        title: Text(titleName),<br>      ),<br>      body: Center(child: showContent()), //使用 method showContent() 來判斷讀取狀態、以及要顯示的畫面<br>    );<br>  }<br><br>  Widget showContent() {<br>    if (_isLoading == true) { //讀取中顯示走路小人<br>      return const LoadingIndicator();<br>    } else if (_errorText != null) { //讀取失敗（錯誤訊息非 null）出現無法連結圖標<br>      return const Icon(Icons.cloud_off);<br>    } else {<br>      return RestaurantList(restaurantList: _restaurantList); //讀取成功返回餐廳列表<br>    }<br>  }<br>}</pre><p><strong>&gt; 呼叫讀取資訊</strong></p><pre>class RestaurantList extends StatelessWidget {<br>  const RestaurantList({<br>    super.key,<br>    required List restaurantList, <br>  }) : _restaurantList = restaurantList; //：在構造函數執行之前初始化列表。這一段是 extract widget 時自動設置的xD<br><br>  final List _restaurantList;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return ListView.builder(<br>      itemCount: _restaurantList.length,<br>      itemBuilder: (context, index) {<br>        Restaurant restaurant = _restaurantList[index]; //取得每一列要顯示的餐廳資訊<br>        return Container(<br>          padding: const EdgeInsets.all(16.0),<br>          child: Row(<br>            mainAxisAlignment: MainAxisAlignment.spaceBetween,<br>            children: [<br>              RestaurantName(restaurant: restaurant), //顯示餐廳中英文名（詳細程式碼見下方）<br>              const Spacer(),<br>              RestaurantButtons(restaurant: restaurant), //顯示動作按鈕（詳細程式碼見下方）<br>            ],<br>          ),<br>        );<br>      },<br>    );<br>  }<br>}<br><br>//顯示餐廳中英文名<br>class RestaurantName extends StatelessWidget {<br>  const RestaurantName({<br>    super.key,<br>    required this.restaurant,<br>  });<br><br>  final Restaurant restaurant;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Column(<br>      crossAxisAlignment: CrossAxisAlignment.start,<br>      children: [<br>        Text(<br>          restaurant.restaurantNameChi, //讀取餐廳的中文名稱<br>          style: const TextStyle(fontSize: 16),<br>        ),<br>        Text(<br>          restaurant.restaurantNameEng, //讀取餐廳的英文名稱<br>          style: const TextStyle(fontSize: 14),<br>        ),<br>      ],<br>    );<br>  }<br>}<br><br>//顯示動作按鈕<br>class RestaurantButtons extends StatelessWidget {<br>  const RestaurantButtons({<br>    super.key,<br>    required this.restaurant,<br>  });<br><br>  final Restaurant restaurant;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Row(<br>      children: [<br>        GoogleMapButton(restaurant: restaurant), //跳轉顯示該餐廳的 Google Map 頁面<br>        LocationButton(restaurant: restaurant), //顯示餐廳地圖<br>        CommentButton(restaurant: restaurant), //顯示餐廳備註<br>      ],<br>    );<br>  }<br>}</pre><h4><strong>🐾 urlLauncher</strong></h4><p>url_launcher 是 Flutter 中一個常用的插件，用來打開網頁、發送郵件、撥打電話等外部應用。你可以使用這個插件來啟動手機上註冊的外部應用來處理特定的 URL，比如 http, tel, mailto 等。</p><p><strong>&gt; </strong><a href="https://pub.dev/packages/url_launcher/install"><strong>安裝方式</strong></a></p><p>在 terminal 輸入以下指令：</p><pre>flutter pub add url_launcher</pre><p>在要使用的頁面 import 套件：</p><pre>import &#39;package:url_launcher/url_launcher.dart&#39;;</pre><p><strong>&gt; 檢查並開啟連結</strong></p><pre>Future&lt;void&gt; _launchURL(String url) async { //使用 Future<br>  // 打開網頁<br>  final Uri url = Uri.parse(&#39;https://flutter.dev&#39;);<br>  await launchUrl(url);<br>  <br>  // 撥打電話<br>  final Uri tel = Uri.parse(&#39;tel:+123456789&#39;);<br>  await launchUrl(tel);<br>  <br>  // 發送郵件<br>  final Uri email = Uri.parse(&#39;example@example.com&#39;);<br>  await launchUrl(email);<br><br>  //檢查此連結是否能開啟<br>  if (await canLaunchUrl(url)) {<br>    await launchUrl(url);<br>  } else {<br>    throw &#39;Could not launch https://flutter.dev&#39;;<br>  }<br>}</pre><p><strong>＊Future:</strong><br>Future 是 Dart 中用來處理異步操作的物件。當你進行一個異步操作時（如網路請求、文件讀取、資料庫操作等），這個操作可能需要一些時間來完成，而不會立即返回結果。Future 代表一個未來某個時刻將會提供結果的計算。<br>async 用來標記一個方法為異步方法。當你使用 async 關鍵字時，該方法會被轉換為一個返回 Future 的異步方法。即便這個方法內部可能包含同步代碼，只要加上 async，它的返回型別就會是 Future。</p><p>await 用來等待一個 Future 的結果。當程序遇到 await，它會等待 Future 完成之後再繼續執行後面的程式碼，而不會阻塞主線程。這樣可以避免應用程式因等待長時間操作（例如網路請求）而無法繼續其他工作。</p><h4>跳轉 Google Map</h4><p>在這份應用中，使用 urlLauncher 開啟 Google Map：</p><pre>class GoogleMapButton extends StatelessWidget {<br>  const GoogleMapButton({<br>    super.key,<br>    required this.restaurant,<br>  });<br><br>  final Restaurant restaurant;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return IconButton(<br>      onPressed: () async {<br>        Uri uri = Uri.parse(restaurant.restaurantLink); //餐廳的 google map 連結<br>        try {<br>          //  如果可以打開，則 await 開啟瀏覽器<br>          if (await canLaunchUrl(uri)) {<br>            await launchUrl(uri);<br>          } else {<br>            // 如果無法打開 URL，則進行錯誤處理<br>            throw &#39;Could not launch ${restaurant.restaurantLink}&#39;;<br>          }<br>        } catch (e) { //程式錯誤則 print 出原因<br>          print(&#39;error: $e&#39;);<br>        }<br>      },<br>      icon: const Icon(Icons.travel_explore),<br>    );<br>  }<br>}</pre><h4>🐾 Dialogue</h4><p>Dialog 是一種彈出視窗，可以顯示通知、選項或操作提示給用戶。常見的對話框類型有之前學過的 AlertDialog、 也可以自定義 Dialog：</p><pre>//showDialog(context:,builder:)<br>showDialog(<br>  context: context,<br>  builder: (BuildContext context) {<br>    //Dialog widget<br>    return Dialog(<br>      //shape: 設定對話框的形狀，例如圓角。<br>      shape: RoundedRectangleBorder(<br>        borderRadius: BorderRadius.circular(20),<br>      ),<br>      //Dialog 內部內容<br>      child: Container(<br>        height: 200,<br>        child: Column(<br>          children: &lt;Widget&gt;[<br>            Text(&#39;這是一個自定義的對話框，可以加入任何內容。&#39;),<br>            ElevatedButton(<br>              onPressed: () {<br>                Navigator.of(context).pop();<br>              },<br>              child: Text(&#39;關閉&#39;),<br>            ),<br>          ],<br>        ),<br>      ),<br>    );<br>  },<br>);</pre><h4>顯示餐廳地圖</h4><pre>class LocationButton extends StatelessWidget {<br>  const LocationButton({<br>    super.key,<br>    required this.restaurant,<br>  });<br><br>  final Restaurant restaurant;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return IconButton(<br>      onPressed: () {<br>        showDialog( <br>            context: context,<br>            builder: (BuildContext context) {<br>              return MapDialogue(restaurant: restaurant);//自定義 dialog，詳細程式碼見下方。<br>            });<br>      },<br>      icon: const Icon(Icons.pin_drop),<br>    );<br>  }<br>}<br><br>//自訂義的 MapDialogue<br>class MapDialogue extends StatelessWidget {<br>  const MapDialogue({<br>    super.key,<br>    required this.restaurant,<br>  });<br><br>  final Restaurant restaurant;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Dialog(<br>      elevation: 8,<br>      insetPadding: const EdgeInsets.all(4),<br>      shape: RoundedRectangleBorder(<br>        borderRadius: BorderRadius.circular(18),<br>      ),<br>      clipBehavior: Clip.hardEdge,<br>      child: Stack(<br>        alignment: AlignmentDirectional.topEnd,//對齊右上角<br>        children: [<br>          ZoomableMap(restaurant: restaurant), //可放大拖曳的地圖。詳細程式碼見下方。<br>          DisMissButton(),<br>        ],<br>      ),<br>    );<br>  }<br>}<br><br><br>//關閉 Dialog 的按鈕<br>class DisMissButton extends StatelessWidget {<br>  const DisMissButton({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return IconButton(<br>        onPressed: () {<br>          Navigator.pop(context);<br>        },<br>        icon: Icon(<br>          Icons.cancel,<br>          color: Colors.grey.withAlpha(180),<br>        ));<br>  }<br>}</pre><h4>🐾InteractiveViewer</h4><p>手指移動拖曳、捏合放大功能。這部分比 swift 好寫很多！！</p><pre>InteractiveViewer(<br><br>  panEnabled: false, // 禁用平移功能，無法拖曳移動（默認為 true)<br>  boundaryMargin: EdgeInsets.all(100.0), // 設置邊界邊距，允許用戶將視圖移動到顯示範圍外 100 像素<br><br>  scaleEnabled: false, // 禁用縮放，無法捏合放大縮小（默認為 true)<br>  minScale: 0.5, // 最小縮放比例<br>  maxScale: 4.0, // 最大縮放比例<br><br>  child: Image.asset(&#39;assets/xxx.png&#39;),<br>)</pre><p><strong>可放大移動的地圖圖片</strong></p><pre>class ZoomableMap extends StatelessWidget {<br>  const ZoomableMap({<br>    super.key,<br>    required this.restaurant,<br>  });<br><br>  final Restaurant restaurant;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    double screenWidth = MediaQuery.of(context).size.width;<br>    double screenHeight = MediaQuery.of(context).size.height;<br>    return Container(<br>        width: (screenHeight &gt; screenWidth) //依照顯示器直橫向進行設置<br>            ? screenWidth * 0.96<br>            : screenHeight * 0.8 / 1251 * 1063, //地圖圖片比例<br>        height: (screenHeight &gt; screenWidth)<br>            ? screenWidth * 0.96 / 1063 * 1251<br>            : screenHeight * 0.8,<br>        alignment: Alignment.center,<br>        child: InteractiveViewer(<br>          minScale: 1, //設置縮放倍數限制<br>          maxScale: 5,<br>          child: Stack(<br>            fit: StackFit.expand, //使 stack 中的 childWidget 填滿空間<br>            alignment: Alignment.center,<br>            children: [<br>              Image.asset(&#39;assets/background.png&#39;, fit: BoxFit.cover),<br>              Image.network(restaurant.imageLink, fit: BoxFit.cover),<br>            ],<br>          ),<br>        ));<br>  }<br>}</pre><h4><strong>🐾 showModalBottomSheet</strong></h4><p>showModalBottomSheet 用來在應用的底部顯示一個模態（Modal）底部彈出面板。這種面板常用來展示更多選項或輸入表單，當用戶與它交互時，主頁面的內容會被遮蓋。</p><pre>showModalBottomSheet(<br>  backgroundColor: Colors.blue[100], // 自定義背景顏色<br>  shape: RoundedRectangleBorder( // 自定義圓角形狀<br>    borderRadius: BorderRadius.vertical(top: Radius.circular(25.0)),<br>  ),<br>  isDismissible: false, // 禁止點擊背景關閉（默認為 true)<br>  enableDrag: false,    // 禁止向下滑動關閉（默認為 true)<br><br>  context: context,<br>  builder: (BuildContext context) {<br>    return Container(<br>      height: 200,<br>      child: Center(<br>        child: Text(&#39;This is a modal bottom sheet&#39;),<br>      ),<br>    );<br>  },<br>);</pre><p><strong>底部彈出的備註欄</strong></p><pre>class CommentButton extends StatelessWidget {<br>  const CommentButton({super.key, required this.restaurant});<br><br>  final Restaurant restaurant;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return IconButton(<br>      onPressed: () {<br>        showModalBottomSheet( //跳出底部面板<br>            context: context,<br>            builder: (BuildContext context) {<br>              return SizedBox(<br>                height: ScreenSize.getStandardSize(context).height * 0.42,<br>                child: Column(<br>                  children: [<br>                    Text(<br>        &#39;${restaurant.restaurantNameChi} ${restaurant.restaurantNameEng}&#39;), //餐廳中英文名<br>                    NoteContent(restaurant: restaurant), //該餐廳的備註。詳細程式碼見下方。<br>                  ],<br>                ),<br>              );<br>            });<br>      },<br>      icon: const Icon(Icons.sticky_note_2_outlined),<br>    );<br>  }<br>}<br><br>//該餐廳的備註<br>class NoteContent extends StatelessWidget {<br>  const NoteContent({<br>    super.key,<br>    required this.restaurant,<br>  });<br><br>  final Restaurant restaurant;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Expanded(<br>      child: Padding(<br>        padding: const EdgeInsets.all(16.0),<br>        child: SingleChildScrollView(<br>          child: ListTile(<br>            title: Text(restaurant.notes),<br>          ),<br>        ),<br>      ),<br>    );<br>  }<br>}</pre><h4><strong>🐾 更改 App 顯示名稱與圖標</strong></h4><p>medium 上有找到這個一次更改好所有圖標的教學：</p><p><a href="https://medium.com/@xemexpress/%E9%BB%9E%E6%A8%A3-flutter-web-%E6%94%B9-icon-26278de0acbb">點樣 Flutter web 改 icon？</a></p><p>不過我這個應該只會發布 chrome app，就簡單修改 web 部分的就好啦！在 web 料夾下找到 icons 資料夾以及 favicon.png ，將自己要使用的 logo 圖片改成同名、同尺寸檔案就可以啦。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/606/1*KPuqe0tvyiElD7G-eK2TTA.png" /></figure><p>再到 web &gt; index.html 確認 icon 的路徑、也可以在這裡修改 app 顯示名稱：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NOjaCgx8xegOW4-H_awO-Q.png" /></figure><h3>Resources:</h3><p><a href="https://www.economic.taichung.gov.tw/47934/post">第二公有零售市場</a></p><h3>Github 連結</h3><p><a href="https://github.com/Pei-7/pei_food_map">GitHub - Pei-7/pei_food_map</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1cfdc69fb3c9" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/flutter-hw-09-food-map-1cfdc69fb3c9">Flutter HW#09 — food map</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Flutter作業#08 — 解謎小遊戲]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-08-%E8%A7%A3%E8%AC%8E%E5%B0%8F%E9%81%8A%E6%88%B2-baea23d0bb30?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/baea23d0bb30</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Tue, 27 Aug 2024 12:20:51 GMT</pubDate>
            <atom:updated>2024-09-08T08:21:56.367Z</atom:updated>
            <content:encoded><![CDATA[<h3>Flutter作業#08 — 解謎小遊戲</h3><p>結合各種輸入元件 &amp; 顯示 alert 的 Flutter App</p><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84%E8%A9%A6%E7%85%89-%E5%8B%87%E8%80%85%E7%9A%84-100-%E9%81%93-swift-ios-app-%E8%AC%8E%E9%A1%8C/233-%E7%B5%90%E5%90%88%E5%90%84%E7%A8%AE%E8%BC%B8%E5%85%A5%E5%85%83%E4%BB%B6-%E9%A1%AF%E7%A4%BA-alert-%E7%9A%84-swiftui-uikit-flutter-app-0b742250143d">#233 結合各種輸入元件 &amp; 顯示 alert 的 SwiftUI / UIKit / Flutter App</a></p><pre>目錄<br><br>  <a href="#1120">gif 展示 </a><br><br>  <a href="#f6c5">網頁連結 </a><br><br>  小筆記 <br>   🐾 <a href="#7219">TextField</a><br>   🐾 <a href="#807f">AlertDialog</a><br>   🐾 <a href="#abeb">SnackBar</a><br>   🐾 <a href="#af06">Switch</a><br>   🐾 <a href="#d5c2">Slider</a><br>   🐾 <a href="#2103">SegmentedButton</a><br>   🐾 <a href="#7d25">Drawer</a><br>   🐾 <a href="#90f6">override initState</a><br>   🐾 <a href="#8888">GoogleFonts</a><br>   🐾 <a href="#392b">ConstrainedBox</a><br>   🐾 <a href="#a7cf">Navigator 跳轉並移除前面的路由</a><br><br>  <a href="#5acc">基本架構</a> <br><br>  程式碼拆解 <br>   🐾 <a href="#883a">側邊目錄欄（練習 Drawer）</a><br>   🐾 <a href="#1899">密信解謎（練習 TextField, AlertDialogue, SnackBar）</a><br>   🐾 <a href="#16d3">牆壁障礙（練習 Switch, Slider）</a><br>   🐾 <a href="#d6b0">門鎖密碼（練習 initState）</a><br>   🐾 <a href="#73f2">貓咪換裝（練習 Segmented Button）</a><br><br>  <a href="#af9a">GitHub 連結</a></pre><h3>gif 演示</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/322/1*M5YaW70NH0Jxn4_PcgNe-Q.gif" /></figure><ul><li>圖片素材皆來自於 <a href="https://chojugiga.com/">https://chojugiga.com/</a> （超級可愛的插畫素材庫！可以免費用於非商業設計哦～）</li><li>本來只是想要做幾頁解謎題目來練習各種輸入 Widget 的，結果插畫太可愛啦，忍不住就寫成了一個小故事還給加了封面封底😆😆</li></ul><h3>網頁連結</h3><figure><a href="https://pei-7.github.io/usagi_game/"><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4UZXjRhHTRIXLbqVsPdEMw.png" /></a></figure><p><a href="https://pei-7.github.io/usagi_game/">usagi_game</a></p><p>＊有先請我的姊姊們幫我試玩啦😆 應該都能順利解出～？如果實在想不到解法的話，回到首頁的側邊目錄欄也可以參考解答🤣🤣</p><h3>小筆記</h3><h4>🐾 TextField</h4><p>在 Flutter 中，TextField 是一個常見的用來接收用戶輸入的 widget。它可以用來輸入文字、數字等資訊，並且可以自訂許多屬性來滿足不同的需求。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/582/1*_Jny8chCFhbYd2BvYEX2gw.png" /></figure><pre>//controller: 用來控制和監聽 TextField 的輸入內容。<br>TextEditingController controller = TextEditingController(); //**給自己的小提醒：於 State 中宣告，確保 build 刷新後不會被一起重建<br><br>//focusNode: 用來控制 TextField 的焦點，例如自動聚焦、取消聚焦等。<br>FocusNode _focusNode = FocusNode();<br><br>TextField(<br>  controller: _controller, <br>  focusNode: _focusNode,<br><br>  //decoration: 用來自訂 TextField 的外觀，例如標籤、提示文字、邊框等。<br>  decoration: InputDecoration(<br>    labelText: &#39;Username&#39;, //點擊 TextField 後會縮至左上角<br>    hintText: &#39;Enter your username&#39;, //點擊 TextField 後會直接隱藏<br>    prefixIcon: Icon(Icons.person), //在輸入框前面顯示的圖標，可為 Icon 或 IconButton<br>    suffixIcon: IconButton(icon: Icon(Icons.clear),<br>      onPressed: () {<br>        _controller.clear(); // 清除輸入框內容<br>      },<br>    ), //在輸入框尾端顯示的圖標，可為 Icon 或 IconButton<br>  ),<br><br>  //keyboardType: 指定輸入框的鍵盤類型，例如數字鍵盤、文字鍵盤等。<br>  keyboardType: TextInputType.number, // 數字鍵盤<br><br><br>  //obscureText: 如果設為 true，則輸入的內容會以密碼形式顯示（例如替換為 * 號）。<br>  obscureText: true,<br><br>  //maxLength: 設置輸入框的最大字數限制。<br>  maxLength: 10,<br><br>  //maxLines: 可輸入多行 &gt;&gt; 但是當 (obscureText == true) 時只能一行！<br>  maxLines: 1,<br><br>  //onChanged: 當輸入框的內容發生變化時觸發的回調函數。<br>  onChanged: (text) { <br>    print(&quot;Text changed: $text&quot;);<br>  },<br><br>  //onSubmitted: 提交輸入時觸發的回調函數（在鍵盤上按下 Enter 鍵）。<br>  onSubmitted: (text) {<br>    print(&quot;Text submitted: $text&quot;);<br>  },<br>)<br><br><br><br>//控制 TextField<br>_controller.text = &quot;Hello, Flutter!&quot;; // 設置文本內容<br>String currentText = _controller.text; // 獲取文本內容<br>_controller.clear(); // 清空輸入框<br><br>// 畫面顯示時自動聚焦到此 TextField<br>@override<br>void initState() {<br>  super.initState();<br>  _focusNode.requestFocus();<br>}<br><br>//取消聚焦（隱藏鍵盤）<br>_focusNode.unfocus();<br>//如果 TextField 沒有設置自己的 focusNode，也可以直接使用 FocusScpoe 直接取消畫面上所有控件的焦點：<br>FocusScope.of(context).unfocus();</pre><h4>🐾 AlertDialog</h4><p>AlertDialog 是 Flutter 中用來展示彈出對話框的常用組件。它通常用於顯示重要的消息、警告、確認操作或顯示一些簡單的選項給用戶選擇。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/458/1*9cA0xNRuFUwUm4L_MLvJOw.png" /></figure><pre><br>showDialog(<br>  context: context,<br>  builder: (BuildContext context) {<br>    return AlertDialog(<br><br>      //title: 對話框的標題<br>      title: Text(&quot;標題&quot;),<br><br>      //content: 對話框的內容<br>      content: Text(&quot;這是對話框的內容&quot;),<br><br>      //scrollable: bool 類型，如果內容過長，設置是否可以滾動，默認為 false。<br>      scrollable: true,<br><br>      //actions: 通常是 TextButton 或 ElevatedButton，表示對話框的操作按鈕，比如 &quot;確定&quot; 和 &quot;取消&quot;。<br>      actions: &lt;Widget&gt;[<br>        TextButton(<br>          child: Text(&quot;取消&quot;),<br>          onPressed: () {<br>            Navigator.of(context).pop(); // 關閉對話框<br>          },<br>        ),<br>        TextButton(<br>          child: Text(&quot;確定&quot;),<br>          onPressed: () {<br>            // 執行確定操作<br>            Navigator.of(context).pop(); // 關閉對話框<br>          },<br>        ),<br>      ],<br>    );<br>  },<br>);</pre><h4>🐾 Snack Bar</h4><p>SnackBar 是 Flutter 中用來在頁面底部短暫顯示消息的控件，常用於向用戶提供輕量級的反饋，比如操作成功、提示信息等。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/620/1*L3yPeOyOQp-mx94tc2XLWA.png" /></figure><pre>//設置 SnackBar<br>ScaffoldMessenger.of(context).showSnackBar(<br>  SnackBar(<br>    //content: Snack bar 的內容<br>    content: Text(&#39;這是一條消息！&#39;),<br><br>    //duration: 控制 SnackBar 顯示的時長，默認是 4 秒。<br>    duration: Duration(seconds: 2),<br><br>    //behavior: SnackBarBehavior 類型，定義 SnackBar 的行為，可以是 fixed（固定在底部）或 floating（浮動）。<br>    behavior: SnackBarBehavior.floating,<br><br>    //action: SnackBarAction 類型，為 SnackBar 添加一個操作按鈕，比如 “取消” 或 “重試”。這個屬性通常用來讓用戶有機會撤銷或響應某些操作。<br>    action: SnackBarAction(<br>      label: &#39;取消&#39;,<br>      onPressed: () {<br>        // 執行取消操作<br>      },<br>    ),<br>  ),<br>);<br><br>//隱藏當前顯示的 SnackBar。<br>ScaffoldMessenger.of(context).hideCurrentSnackBar();<br><br>//立即隱藏當前顯示的 SnackBar 並從隊列中移除。(*** 當 showSnackBar 被n次觸發時，會有n個 Snack Bar 排著隊等著一一顯示😂<br>ScaffoldMessenger.of(context).removeCurrentSnackBar();<br><br>//清除所有待顯示的 SnackBar。<br>ScaffoldMessenger.of(context).clearSnackBars();<br></pre><h4>🐾 Switch</h4><p>Switch 是 Flutter 中用來創建開關控件的組件，常用於用戶在開關狀態之間進行切換。這個控件通常用於設置頁面或選項切換。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/214/1*vcezNiuKfz3ifCK7-Bj8KQ.png" /></figure><pre>class _MyWidgetState extends State&lt;MyWidget&gt; {<br>bool isSwitched = false;<br>}<br><br>Switch(<br>  //value:  bool 類型，表示當前開關的狀態（true 為打開，false 為關閉）。<br>  value: isSwitched,<br><br>//Color: 設置開關打開時的顏色。<br>activeColor: Colors.green,<br><br>//inactiveThumbColor: Color 類型，設置開關關閉時開關圓形的顏色。<br>inactiveThumbColor: Colors.grey,<br><br>//inactiveTrackColor: Color 類型，設置開關關閉時軌道的顏色。<br>inactiveTrackColor: Colors.red,<br><br>  //onChanged: ValueChanged&lt;bool&gt; 回調函數，當開關狀態發生變化時會調用此函數，並傳遞當前的值。<br>  onChanged: (value) {<br>    setState(() {<br>      isSwitched = value;<br>    });<br>  },<br>),</pre><h4>🐾 Slider</h4><p>Slider 是 Flutter 中用來讓用戶選擇範圍內的數值的一個控件。通常用於設置音量、亮度等可調節的數值。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/314/1*jXOlzhOJiI59haF0Yf-zyw.png" /></figure><pre>class _MyWidgetState extends State&lt;MyWidget&gt; {<br>double _currentValue = 0.5;<br>}<br><br>Slider(<br>  //value: double 類型，表示滑塊當前的值。這個值應該在 min 和 max 之間。<br>  value: _currentValue,<br><br>  //min/max: double 類型，滑塊的最小及最大值。<br>  min: 0.0,<br>  max: 1.0,<br><br>  //divisions: int 類型，定義滑塊的可選擇的分段數。這個值設定為 null 時，滑塊是連續的。<br>  divisions: 10,<br><br>  //activeColor: Color 類型，設置滑塊的主色（即滑塊的顏色）。<br>  activeColor: Colors.blue,<br>  //inactiveColor: Color 類型，設置滑塊未激活時的顏色。<br>  inactiveColor: Colors.grey,<br>  //thumbColor: Color 類型，設置滑塊指針的顏色。<br>  thumbColor: Colors.red,<br><br>  //label: String 類型或 Text 小部件，顯示在滑塊指針上方的標籤。通常用來顯示當前值的描述。<br>  label: _currentValue.toStringAsFixed(1),<br><br>  //onChanged: ValueChanged&lt;double&gt; 回調函數，當滑塊值發生改變時調用。此回調函數會傳遞當前的滑塊值。<br>  onChanged: (double value) {<br>    setState(() {<br>      _currentValue = value;<br>    });<br>  },<br>),</pre><h4>🐾 SegmentedButton</h4><p>SegmentedButton 用於在一個水平或垂直排列的選項組中選擇一個或多個選項。這個組件非常適合用來替代傳統的 RadioButton 和 CheckBox 的組合。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/552/1*PeH2WBCGFaNldvyRbL8Bqg.png" /></figure><pre>SegmentedButton&lt;String&gt;(<br>  //segments: 這是一個 List&lt;ButtonSegment&lt;T&gt;&gt;，表示按鈕分段，每個分段可以包含一個值、標籤（文本）和一個圖標。<br>  segments: const &lt;ButtonSegment&lt;String&gt;&gt;[<br>    ButtonSegment(<br>      value: &#39;Option 1&#39;,<br>      label: Text(&#39;Option 1&#39;),<br>      icon: Icon(Icons.looks_one),<br>    ),<br>    ButtonSegment(<br>      value: &#39;Option 2&#39;,<br>      label: Text(&#39;Option 2&#39;),<br>      icon: Icon(Icons.looks_two),<br>    ),<br>    ButtonSegment(<br>      value: &#39;Option 3&#39;,<br>      label: Text(&#39;Option 3&#39;),<br>      icon: Icon(Icons.looks_3),<br>    ),<br>  ],<br><br>  //multiSelectionEnabled: 一個布爾值，表示是否允許多選。默認為 false。<br>  multiSelectionEnabled: true,<br><br>  //selected: 用於指定當前選中的值。這是一個 Set&lt;T&gt;，可以存儲單選或多選的結果。<br>  selected: &lt;String&gt;{selectedValue},<br><br>  //onSelectionChanged: 當用戶選擇新選項時調用的回調函數，參數是一個新的選中值的 Set&lt;T&gt;。<br>  onSelectionChanged: (Set&lt;String&gt; newSelection) {<br>    setState(() {<br>      selectedValue = newSelection.first;<br>    });<br>  },<br><br>);</pre><h4>🐾 Drawer</h4><p>Drawer 是一個常見的側邊導航選單，通常用於應用程式的側邊滑出式選單。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/247/1*P9SobyGUVsfrzMcAJVCTFw.png" /></figure><pre>Scaffold(<br>    appBar: AppBar(...),<br><br>    drawer: Drawer(<br>      child: ListView( //通常用 ListView 或 Column<br>        children: &lt;Widget&gt;[<br><br>          //DrawerHeader: 來設置 Drawer 的標題區域，通常用於顯示用戶的名稱或應用程式的標誌：<br>          DrawerHeader(<br>            decoration: BoxDecoration( //設置 header 樣式<br>              color: Colors.blue,<br>            ),<br>            child: Text( //設置 header 文字<br>              &#39;Drawer Header&#39;,<br>            ),<br>          ),<br><br>          //在 Drawer 中添加的列表項目通常使用 ListTile<br>          ListTile(<br>            title: Text(&#39;選項 1&#39;),<br>            onTap: () {...},<br>          ),<br>          ListTile(<br>            title: Text(&#39;選項 2&#39;),<br>            onTap: () {...},<br>          ),<br><br>        ],<br><br>      ),<br>    ),<br>    body: ...<br>  ),<br>);</pre><h4>🐾 override initState</h4><p>類似 xcode 的 viewDidLoad，設置初始狀態：當創建 StatefulWidget 時，initState 方法會在 State 對象的生命周期內只調用一次，並在 build 方法首次被調用之前執行。</p><p>通常用於設置 State 變量的初始值、設置控制器、發起一次性的網路請求、或是註冊事件監聽器。</p><h4>🐾 GoogleFonts</h4><p><a href="https://fonts.google.com/">Browse Fonts - Google Fonts</a></p><p>在 terminal 輸入指令：</p><pre>flutter pub add google_fonts</pre><p>要使用的地方 import 套件：</p><pre>import &#39;package:google_fonts/google_fonts.dart&#39;;<br><br>Text(<br>  &#39;Hello, Google Fonts!&#39;,<br>  style: GoogleFonts.lato( //在 style 這邊直接輸入 GoogleFonts.字體名稱(textStyle:)<br>    textStyle: TextStyle( //就可以直接使用 TextStyle() 設定啦！<br>      fontSize: 24,<br>      fontWeight: FontWeight.bold,<br>      color: Colors.black,<br>    ),<br>  ),<br>),</pre><p>第一次呼叫 GoogleFonts 會自動跳出錯誤提示，右鍵點擊直接 import 需要的library 就可以啦！</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*w1OhEqZMuCOUy0lnATsfUA.png" /></figure><h4>🐾 ConstrainedBox</h4><p>用於設置其 child widget 的最小和最大寬度與高度，確保 widget 不會過小 or 過大。</p><pre>ConstrainedBox(<br>  constraints: BoxConstraints(<br>    minWidth: 100,<br>    maxWidth: 200,<br>    minHeight: 50,<br>    maxHeight: 100,<br>  ),<br>  child: YourWidget(),<br>)</pre><h4>🐾 Navigator 跳轉並移除前面的路由：</h4><pre>Navigator.pushAndRemoveUntil(<br>  context,<br>  MaterialPageRoute(builder: (context) =&gt; Cover()),<br>  (Route&lt;dynamic&gt; route) =&gt; false, // 移除所有之前的路由<br>);</pre><h3>基本架構</h3><p>因為每個頁面架構大致相同，只是主要顯示不同圖片及文字，故直接設置了一個 custom scaffold: class UsagiScaffold。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LKw1cOooUaRNFFwdHSwEQQ.png" /></figure><h3>程式碼拆解</h3><h4>🐾 側邊目錄欄（練習 Drawer）</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/329/1*mRXHDtO3R2q-FvFsrSiEow.png" /></figure><pre>class UsagiScaffold extends StatelessWidget {<br>  final Widget content;<br>  final bool? isCover;<br><br>  const UsagiScaffold({<br>    super.key,<br>    required this.content,<br>    this.isCover,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Scaffold(<br>      appBar: AppBar( //設置頂部 AppBar<br>        backgroundColor: themeColorLight,<br>        leading: (isCover == true) //確認是否是封面頁<br>            ? null //封面頁不改變 default 的 drawer 按鈕<br>            : IconButton( //非封面頁（內頁的話）則 leading button 變為 &quot;返回&quot; 按鈕<br>                icon: const Icon(Icons.arrow_back_ios_new),<br>                onPressed: () {<br>                  Navigator.of(context).pop(); // Navigate 回上一頁<br>                },<br>              ),<br>      ),<br>      drawer: const UsagiDrawer(), //Drawer widget，詳細程式碼見下方<br>      body: Center(...),<br>      backgroundColor: themeColorLight,<br>    );<br>  }<br>}<br><br>//Drawer widget<br>class UsagiDrawer extends StatelessWidget {<br>  const UsagiDrawer({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Drawer(<br>      backgroundColor: themeColorDark,<br>      child: Column( //因會為用到 Spacer() 故這邊使用 Column 而非 ListView<br>        children: [<br>          DrawerHeader(child: Image.asset(&#39;assets/drawerIcon.png&#39;)), //Drawer 的 header 設置了一張圖片<br>          const DrawerListTile(tileName: &#39;首頁&#39;, navigatePage: Cover()), //跳轉回首頁，詳細設置見下方 DrawerListTile。<br>          const DrawerListTile(tileName: &#39;解答&#39;, navigatePage: Solution()), //跳轉至解答頁。<br>          const Spacer(), //佔位符，使下面的 CreditTile 可以置底<br>          const CreditTile(), //標示素材庫網站，詳細設置見下方 CreditTile。（本來想要點擊跳轉至該網頁，但是發現 URL 需要額外的套件？等以後學到了這一部分再回來修改好啦～<br>        ],<br>      ),<br>    );<br>  }<br>}<br><br><br>//DrawerListTile<br>class DrawerListTile extends StatelessWidget {<br>  const DrawerListTile({<br>    super.key,<br>    required this.tileName,<br>    required this.navigatePage,<br>  });<br><br>  final String tileName;<br>  final Widget navigatePage;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return ListTile(<br>      title: Text(tileName, style: const TextStyle(color: Colors.white)),<br>      onTap: () {<br>        Navigator.pushAndRemoveUntil(//跳轉並移除之前的路由<br>          context,<br>          MaterialPageRoute(builder: (context) =&gt; navigatePage),<br>          (Route&lt;dynamic&gt; route) =&gt; false, //這段程式碼可以移除之前的路由路徑<br>        );<br>      },<br>    );<br>  }<br>}<br><br>//CreditTile<br>class CreditTile extends StatelessWidget {<br>  const CreditTile({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return const ListTile(<br>      title: Padding(<br>        padding: EdgeInsets.all(12.0),<br>        child: Text(&#39;Usage Quest uses illustrations from chojugiga.com&#39;,<br>            style: TextStyle(fontSize: 14, color: Colors.white)),<br>      ),<br>    );<br>  }<br>}</pre><h4>🐾 密信解謎（練習 TextField, AlertDialogue, SnackBar）</h4><p>其他架構與前面自訂的 UsagiScaffold 差不多，比較特別的是 AnswerField 這個包含了 TextField Widget，故這邊就只筆記這一段程式碼：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fcdfvQYXuMbWtnfMpNN5qg.png" /></figure><p><strong>State 設置：</strong></p><pre>class _P3State extends State&lt;P3&gt; {<br>  //我原本在 build 後才宣告 controller，結果會使得每次 build 重新創建時 controller 也重新創建、導致刷新 State 後，TextField 中的文字都會不見。改到 State 中宣告 controller 就解決啦。<br>  TextEditingController controller = TextEditingController();<br><br>  bool _nextButtonHidden = true; //預設 &quot;下一頁&quot; 按鈕為隱藏<br>  void buttonToggle() {<br>    setState(() {<br>      _nextButtonHidden = false; //取消隱藏 &quot;下一頁&quot; 按鈕<br>      FocusScope.of(context).unfocus(); //收起鍵盤<br>      showSnackbar(context, &#39;解開這封密信了！&#39;);<br>    });<br>  }</pre><p><strong>class AnswerRow：</strong></p><pre>class AnswerField extends StatelessWidget {<br>  const AnswerField({<br>    super.key,<br>    required this.buttonToggle,<br>    required this.controller,<br>  });<br><br>  final void Function() buttonToggle;<br>  final TextEditingController controller;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Row(<br>      mainAxisAlignment: MainAxisAlignment.center,<br>      children: [<br>        SizedBox(<br>          width: ScreenSize.getStandardWidth(context) * 0.7,<br>          child: TextField(<br>            controller: controller, //設定此 textField 的 controller，便於其他地方要讀取/控制此 textField 時呼叫<br>            decoration: InputDecoration( //設定 textField 樣式<br>              labelText: &#39;請破譯信件的內容&#39;,<br>              labelStyle:<br>                  const TextStyle(color: Color.fromARGB(255, 56, 56, 56)),<br>              border: UnderlineInputBorder(// 使用底線樣式<br>                  borderSide: BorderSide(color: themeColorDark, width: 1.0)),<br>              focusedBorder: UnderlineInputBorder( //當 textField 被點擊時，使底線加粗<br>                  borderSide: BorderSide(color: themeColorDark, width: 2.0)),<br>              suffixIcon: IconButton( //textField 尾端設置回車鍵 icon<br>                onPressed: () {<br>                  (controller.text.toUpperCase().contains(&#39;HELP&#39;)) //.toUpperCase() 是為了避免因大小寫(&quot;help&quot;/ &quot;Help&quot;/ &quot;HELP&quot;)導致判別錯誤<br>                      ? buttonToggle() //答對的話顯示下一頁按鈕<br>                      : showIncorrectAlert(context); //答錯的話則跳出 Alert<br>                },<br>                icon: const Icon(Icons.keyboard_return),<br>                style: IconButton.styleFrom(foregroundColor: themeColorDark),<br>              ),<br>            ),<br>            onSubmitted: (text) { //這邊的動作跟回車鍵 icon 一模一樣。<br>              (text.toUpperCase().contains(&#39;HELP&#39;))<br>                  ? buttonToggle()<br>                  : showIncorrectAlert(context);<br>            },<br>          ),<br>        ),<br>      ],<br>    );<br>  }</pre><p><strong>AlertDialog：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/510/1*9WmgD7t7Hq7WGuDikeEKAA.png" /></figure><pre>Future&lt;dynamic&gt; showIncorrectAlert(BuildContext context) { //Future&lt;dynamic&gt; 這個型別是 Extract Widget 時自動設置的<br>    return showDialog(<br>        context: context,<br>        builder: (context) {<br>          return const IncorrectDialogue();<br>        });<br>  }<br>}<br><br>//當回答錯誤時，會跳出 AlertDialog<br>class IncorrectDialogue extends StatelessWidget {<br>  const IncorrectDialogue({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return const AlertDialog(<br>      title: Text(<br>        &#39;兔子先生說：\n「我想這應該不是貓咪先生想表達的意思。」&#39;,<br>        style: TextStyle(fontSize: 18),<br>      ),<br>      content: Text(&#39;請再仔細想想看吧！&#39;),<br>      actions: [<br>        DismissButton(), //關閉 Alert 的按鈕<br>      ],<br>    );<br>  }<br>}<br><br>class DismissButton extends StatelessWidget {<br>  const DismissButton({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return TextButton(<br>      style: TextButton.styleFrom(foregroundColor: themeColorDark),<br>      onPressed: () {<br>        Navigator.of(context).pop(); //回到原本的頁面<br>      },<br>      child: const Text(<br>        &#39;好的&#39;,<br>        style: TextStyle(fontWeight: FontWeight.bold),<br>      ),<br>    );<br>  }<br>}</pre><p><strong>SnackBar：</strong></p><pre>void showSnackbar(BuildContext context, String text) {<br>  ScaffoldMessenger.of(context).showSnackBar( //顯示 SnackBar<br>    SnackBar(<br>      padding: const EdgeInsets.only(bottom: 4, top: 8, left: 24, right: 24),<br>      content: Text(text, style: const TextStyle(fontSize: 14)),<br>      backgroundColor: themeColorDark,<br>    ),<br>  );<br>}<br><br>void hideSnackbar(BuildContext context) { ///隱藏 SnackBar<br>  ScaffoldMessenger.of(context).removeCurrentSnackBar(); //移除現有SnackBar<br>  ScaffoldMessenger.of(context).clearSnackBars(); //當 SnackBar 被多次觸發時，會有多個 SnackBar 排隊等著顯示。避免不小心觸發多次，故一次把隊列清空。<br>}</pre><h4>🐾 牆壁障礙（練習 Switch, Slider）</h4><p>這邊也就只把 SwitchRow 跟 SliderRow 來給自己做個筆記啦：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KIALi6poLXUQdZBfqhFKPQ.png" /></figure><p><strong>State 設置：</strong></p><pre>class _P5State extends State&lt;P5&gt; {<br>  int imageIndex = 1; //兔子圖片有兩種（問號與燈泡），使用 imageIndex 來切換<br>  void toggleIndex() {<br>    setState(() {<br>      (imageIndex == 1) ? imageIndex = 2 : imageIndex = 1;<br>    });<br>  }<br><br> double sliderValue = 255; //使用 slider 操控牆壁的不透明度。初始值為 255(完全不透明)<br>  void changeAlpha(double value) {<br>    setState(() {<br>      sliderValue = value;<br>      if (sliderValue.toInt() == 0) { //當牆壁為完全透明時，則出現成功提示<br>        showSnackbar(context, &#39;成功移除障礙了！&#39;);<br>      }<br>    });<br>  }</pre><p><strong>class SwitchRow：</strong></p><pre>class SwitchRow extends StatelessWidget {<br>  const SwitchRow(<br>      {super.key, required this.imageIndex, required this.toggleIndex});<br><br>  final int imageIndex;<br>  final void Function() toggleIndex;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Row(<br>      mainAxisAlignment: MainAxisAlignment.center,<br>      children: [<br>        const Icon(Icons.question_mark_outlined), //設置 switch 左側（關閉側）圖示<br>        const SizedBox(width: 8),<br>        Switch(<br>          value: (imageIndex == 1) ? false : true, //與兔子圖片連動<br>          activeColor: themeColorDark,<br>          inactiveThumbColor: themeColorDark,<br>          inactiveTrackColor: themeColorLight,<br>          onChanged: (switchStatus) {<br>            toggleIndex(); //切換 imageIndex (圖片路徑為 &#39;assets/p5_$imageIndex.png&#39;,)，故也會相應改變<br>          },<br>        ),<br>        const SizedBox(width: 8),<br>        const Icon(Icons.lightbulb_outline) //設置 switch 右側（開啟側）圖示<br>      ],<br>    );<br>  }<br>}<br><br></pre><p><strong>class SliderRow：</strong></p><pre>class SliderRow extends StatelessWidget {<br>  const SliderRow({<br>    super.key,<br>    required this.imageIndex,<br>    required this.sliderValue,<br>    required this.changeAlpha,<br>  });<br><br>  final int imageIndex;<br>  final double sliderValue;<br>  final void Function(double) changeAlpha;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Visibility( //設置 SliderRow 是否可見<br>      visible: (imageIndex == 1) ? false : true, //與開關連動<br>      maintainSize: true, //當希望不可見但仍然保留位置時，須將這三個 bool 都設置為 true<br>      maintainAnimation: true,<br>      maintainState: true,<br>      child: Row(<br>        mainAxisAlignment: MainAxisAlignment.center,<br>        children: [<br>          const Icon(Icons.lens_blur), // slider 左側圖示<br>          Slider(<br>              value: sliderValue, //設置為可動變數，畫面上才會跟著更新～<br>              min: 0.0, //設置最小 &amp; 最大值<br>              max: 255.0,<br>              thumbColor: themeColorDark,<br>              activeColor: themeColorDark,<br>              inactiveColor: Colors.grey,<br>              onChanged: (value) {<br>                changeAlpha(value); //更新 sliderValue<br>              }),<br>          const Icon(Icons.circle_rounded), // slider 右側圖示<br>        ],<br>      ),<br>    );<br>  }<br>}</pre><h4>🐾 門鎖密碼（練習 initState）</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*26iYqjLwNADBUBBeRz334A.png" /></figure><p><strong>密碼設置：</strong></p><pre>Map&lt;int, String&gt; numberCode = { //用 map 把數字與密碼對照表先列出來<br>  1: &#39;369&#39;,<br>  2: &#39;123654789&#39;,<br>  3: &#39;12365456987&#39;,<br>  4: &#39;1456369&#39;,<br>  5: &#39;321456987&#39;,<br>  6: &#39;3214789654&#39;,<br>  7: &#39;12369&#39;,<br>  8: &#39;63214569874&#39;,<br>  9: &#39;6321456987&#39;,<br>};<br><br>List&lt;int&gt; setRandomPassWord() {<br>  List&lt;int&gt; numList = List.generate(9, (int i) =&gt; i + 1); //先生成 1-9 的數字<br>  numList.shuffle(); //隨機排序<br>  List&lt;int&gt; randomNum = numList.take(4).toList(); //取前四位<br>  return randomNum; //生成四位數密碼啦！<br>}</pre><p><strong>State 設置：</strong></p><pre>class _P8State extends State&lt;P8&gt; {<br>  List&lt;String&gt; code = []; //先宣告型別<br>  String realPassword = &#39;&#39;;<br><br>  @override<br>  void initState() {//使用 initState 使得畫面生成前先設置好密碼與題目<br>    super.initState(); <br>    List&lt;int&gt; randomNum = setRandomPassWord(); //生成隨機四位數密碼(List 型別)<br>    for (var i = 0; i &lt;= 3; i++) {<br>      (realPassword += randomNum[i].toString()); //將 List 型別的密碼轉換為 String <br>    }<br>    if (numberCode[3] != null) {<br>      code = randomNum.map((int i) =&gt; numberCode[i]!).toList(); //對照上面的 Map numberCode，生成題目密碼 List<br>    }<br>  }<br><br>  String inputPassword = &#39;&#39;; //這裡則是記錄使用者輸入的密碼<br>  void updatePassWord(String i) {<br>    setState(() {<br>      if (i == &#39;clear&#39;) { //畫面上的清除鍵會回傳 &quot;clear&quot;，此時清除全部輸入的密碼<br>        inputPassword = &#39;&#39;; <br>      } else if (inputPassword.length &lt; 4) { //點擊數字鍵則會記錄該數字，最多不超過四個字<br>        inputPassword += i;<br>      }<br>    });<br>  }<br><br>  bool lock = true; //設置是否成功解鎖的 bool 值<br>  void unlock() {<br>    setState(() {<br>      lock = false;<br>    });<br>  }</pre><p><strong>class NumberPad：</strong></p><pre>class NumberPad extends StatelessWidget {<br>  const NumberPad({<br>    super.key,<br>    required this.updatePassWord,<br>  });<br>  final void Function(String) updatePassWord;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return SizedBox(//正方形的 SizedBox + GridView，使得內部 children 自動變成圓形<br>      width: ScreenSize.getStandardWidth(context) * 0.4,<br>      height: ScreenSize.getStandardWidth(context) * 0.4,<br>      child: GridView.count( <br>        crossAxisCount: 3,<br>        mainAxisSpacing: 12,<br>        crossAxisSpacing: 12,<br>        children: [<br>          for (var i = 1; i &lt;= 9; i++) //生成九個數字按鍵<br>            NumberButton(<br>              text: i.toString(),<br>              updatePassWord: updatePassWord, //點擊鍵盤的動作<br>            )<br>        ],<br>      ),<br>    );<br>  }<br>}<br><br>  <br>class ToolButtons extends StatelessWidget { //清除鍵與輸入鍵<br>  const ToolButtons(<br>      {super.key,<br>      required this.updatePassWord,<br>      required this.inputPassword,<br>      required this.realPassword,<br>      required this.unlock});<br><br>  final void Function(String) updatePassWord;<br>  final String realPassword;<br>  final String inputPassword;<br>  final void Function() unlock;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return SizedBox(<br>      width: ScreenSize.getStandardWidth(context) * 0.4,<br>      child: Row(<br>        mainAxisAlignment: MainAxisAlignment.spaceBetween,<br>        children: [<br>          NumberButton(<br>            text: &#39;清除&#39;,<br>            updatePassWord: updatePassWord, //清除 inputPassword<br>          ),<br>          NumberButton(<br>            text: &#39;輸入&#39;,<br>            updatePassWord: updatePassWord,<br>            realPassword: realPassword,<br>            inputPassword: inputPassword,<br>            unlock: unlock, //解鎖成功<br>          ),<br>        ],<br>      ),<br>    );<br>  }<br>}<br><br><br><br><br>class NumberButton extends StatelessWidget {<br>  const NumberButton({<br>    super.key,<br>    required this.text,<br>    required this.updatePassWord,<br>    this.inputPassword,<br>    this.realPassword,<br>    this.unlock,<br>  });<br>  final String text;<br>  final void Function(String) updatePassWord;<br>  final String? inputPassword;<br>  final String? realPassword;<br>  final void Function()? unlock;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return ElevatedButton(<br>      onPressed: () {<br>        if (text == &#39;清除&#39;) {<br>          updatePassWord(&#39;clear&#39;); //點擊清除鍵時清空 inputPassword<br>        } else if (text == &#39;輸入&#39;) {<br>          if (inputPassword == realPassword) { //比對預設密碼與輸入密碼，當輸入正確時<br>            unlock!(); //解鎖成功<br>            hideSnackbar(context); //避免 snackBar 隊列阻塞，先清除現有 snackBar<br>            showSnackbar(context, &#39;密碼正確！&#39;); //並顯示最新的 snackBar<br>          } else { //輸入錯誤<br>            hideSnackbar(context);<br>            showSnackbar(context, &#39;密碼錯誤！&#39;);<br>          }<br>        } else {<br>          updatePassWord(text); //點擊數字鍵(非清除 or 輸入鍵）時，則更新密碼<br>        }<br>      },<br>      style: ElevatedButton.styleFrom(<br>          padding: const EdgeInsets.all(0),<br>          backgroundColor: themeColorDark,<br>          foregroundColor: themeColorLight),<br>      child: Text(text,<br>          style: GoogleFonts.orbitron(textStyle: const TextStyle(fontSize: 18)),<br>          textAlign: TextAlign.center),<br>    );<br>  }<br>}<br><br></pre><h4>🐾 貓咪換裝（練習 Segmented Button）</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*I4jjruVitizdaZBiH2wNJg.png" /></figure><p><strong>State 設置：</strong></p><pre>class _P11State extends State&lt;P11&gt; {<br>  String selectedType = &#39;1&#39;; //設置 segmentedButtons 中被選中的項目<br>  void updateSelectedIndex(String newSelection) { //更新被選中項目<br>    setState(() {<br>      selectedType = newSelection;<br>    });<br>  }<br><br>  bool decided = false; <br>  String decisionIndex = &#39;1&#39;; //按下“決定”按鈕後畫面圖片會更新，故也設置了可變的 decisionIndex。圖片路徑：&#39;assets/p11_${selectedType}_$decisionIndex.png&#39;<br>  void updateDecision() { //當按下決定按鈕後的變動<br>    setState(() {<br>      decided = true;<br>      decisionIndex = &#39;2&#39;;<br>    });<br>  }</pre><p><strong>class SelectionButtons：</strong></p><pre>class SelectionButtons extends StatelessWidget {<br>  const SelectionButtons({<br>    super.key,<br>    required this.selectedType,<br>    required this.decided,<br>    required this.updateSelectedIndex,<br>  });<br><br>  final String selectedType;<br>  final bool decided;<br>  final void Function(String) updateSelectedIndex;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return SegmentedButton&lt;String&gt;(<br>      style: SegmentedButton.styleFrom( //設置 segmentedButton 樣式<br>          selectedBackgroundColor: themeColorDark,<br>          selectedForegroundColor: Colors.white),<br>      segments: const [ //設置四個 ButtonSegment<br>        ButtonSegment&lt;String&gt;(value: &#39;1&#39;, label: Text(&#39;自然&#39;)),<br>        ButtonSegment&lt;String&gt;(value: &#39;2&#39;, label: Text(&#39;正義&#39;)),<br>        ButtonSegment&lt;String&gt;(value: &#39;3&#39;, label: Text(&#39;活力&#39;)),<br>        ButtonSegment&lt;String&gt;(value: &#39;4&#39;, label: Text(&#39;專業&#39;)),<br>      ],<br>      selected: {selectedType}, //可變動的 selectedType (如果 multiSelectionEnabled 設置為 true 則可多選，過為 set {})<br>      onSelectionChanged: (newSelection) {<br>        (decided == false) ? updateSelectedIndex(newSelection.first) : null; //因 selected 可以多選，故加 first 表明為第一個<br>      },<br>    );<br>  }<br>}</pre><h3>GitHub 連結</h3><p><a href="https://github.com/Pei-7/usagi_game">GitHub - Pei-7/usagi_game</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=baea23d0bb30" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-08-%E8%A7%A3%E8%AC%8E%E5%B0%8F%E9%81%8A%E6%88%B2-baea23d0bb30">Flutter作業#08 — 解謎小遊戲</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Flutter作業#07 — 貓貓養成小遊戲]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-07-%E8%B2%93%E8%B2%93%E9%A4%8A%E6%88%90%E5%B0%8F%E9%81%8A%E6%88%B2-a2f4c427a387?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/a2f4c427a387</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Wed, 21 Aug 2024 04:48:13 GMT</pubDate>
            <atom:updated>2024-08-21T07:53:55.831Z</atom:updated>
            <content:encoded><![CDATA[<h3>Flutter作業#07 — 貓貓養成小遊戲🐈</h3><p>結合圖片、文字、button 的 Flutter setState 練習題。</p><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84%E8%A9%A6%E7%85%89-%E5%8B%87%E8%80%85%E7%9A%84-100-%E9%81%93-swift-ios-app-%E8%AC%8E%E9%A1%8C/225-%E7%B5%90%E5%90%88%E5%9C%96%E7%89%87-%E6%96%87%E5%AD%97-button-%E7%9A%84-swiftui-state-%E7%B7%B4%E7%BF%92%E9%A1%8C-3cd0ca2b194d">#225 結合圖片、文字、button 的 SwiftUI State / UIKit IBAction / Flutter setState 練習題</a></p><pre>目錄<br><br>  <a href="#3540">gif 展示</a><br><br>  <a href="#e5e0">網頁應用連結</a><br><br>  <a href="#fe33">頁面拆解</a><br><br>  小筆記  <br>     1. <a href="#dd09">Stateless Widget v.s. Stateful Widget</a><br>     2. <a href="#5f65">callback 調用並修改參數</a> <br>     3. <a href="#9900">Map</a> <br>     4. <a href="#7577">(condition) ? true : false</a> <br>     5. <a href="#6028">Opacity （使 Widget 不可見、但仍佔有空間）</a> <br>     6. <a href="#f9c4">Random()</a><br>     7. <a href="#c39c">Navigator</a><br>     8. <a href="#af00">設置不同瀏覽器顯示比例</a><br>     9. <a href="#cfe7">deploy to github pages</a><br><br>  程式碼拆解  <br>     <a href="#2014">Enum 設置</a><br>     <a href="#02bb">遊戲頁 CatPage</a><br>        🐾 初始設置<br>        🐾 State 設置️ 🚩🚩🚩<br>        🐾 Build 畫面<br><br>  <a href="#04a1">GitHub 連結</a></pre><h3>gif 展示</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/322/1*c_rNk48SRVA5ZNoN38ie1w.gif" /></figure><h3>網頁應用連結</h3><figure><a href="https://pei-7.github.io/purr/"><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qRi7g-BUBXK1w4K4pztC1g.png" /></a></figure><p><a href="https://pei-7.github.io/purr/">purr</a></p><p>*p.s. 目前總共設有 13 種養成結果，其中有一些條件設定限制比較多？算是隱藏版結局～😆😆😆</p><h3>頁面拆分</h3><p>總共製作了四個頁面：<strong>遊戲首頁</strong>、<strong>遊戲說明頁</strong>、<strong>遊戲頁</strong>、以及<strong>遊戲結果頁</strong>：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xvco3mqDQlliabhm5YNFMQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FHbDSGkatzwSl9lTtRO4ZQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WGZlbhbXPKqrnTddQ3XoXA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dqG_ej2Hy4B-DNIuP8a2jg.png" /></figure><p>簡單的 StatelessWidget 頁面就不一一說明啦！遊戲主要的重點是 CatPage，因為畫面會依照按鈕點擊而變化，所以需設為 StatelessWidget。</p><p>先整理一下這次作業學到的程式碼小筆記，方便後續記憶與運用～</p><h3><strong>小筆記</strong></h3><h4>1. Stateless Widget v.s. Stateful Widget</h4><p><strong>🐾 StatelessWidget</strong></p><ul><li><strong>描述</strong>: 當 StatelessWidget 被創建後，它的配置數據（如變數、屬性等）在生命周期中是固定不變的。若要重建，則需要由父級 widget 觸發。</li><li><strong>使用場景</strong>: 適合用於靜態顯示內容，不會隨用戶交互或時間而改變的 widget。例如，顯示一段文字、圖標或圖片。</li></ul><pre>class MyStatelessWidget extends StatelessWidget {<br>  final String title;<br><br>  MyStatelessWidget({required this.title});<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Text(title);<br>  }<br>}</pre><p><strong>🐾 StatefulWidget</strong></p><ul><li><strong>描述</strong>: 需要管理內部狀態的 widget。當 widget 的狀態改變時，它可以自行重建畫面以反映新的狀態（不需回到父級 widget）。</li><li><strong>使用場景</strong>: 適合用於動態內容會改變的場景，如用戶輸入、動畫、計時器或任何隨用戶交互變化的內容。例如，按鈕的按下狀態、表單的輸入框。</li></ul><pre>class MyStatefulWidget extends StatefulWidget {<br>  @override<br>  _MyStatefulWidgetState createState() =&gt; _MyStatefulWidgetState();<br>}<br><br>class _MyStatefulWidgetState extends State&lt;MyStatefulWidget&gt; { //會被改變的參數及其變動的程式一定要設置在 State 內！！<br><br>//設置會被改變的變數<br>  int _counter = 0; //前面有 &quot;_&quot; 表示絲有性，除此 class 外不可使用<br>//設置使此變數變動的 function (當要改變該變數時，在 build 內無法直接修改變數，而必須呼叫此 function 才可進行修改。<br>  void _incrementCounter() {<br>    setState(() {<br>      _counter++;<br>    });<br>  }<br><br>  @override<br>  Widget build(BuildContext context) { //build<br>    return Column(<br>      children: [<br>        Text(&#39;Counter: $_counter&#39;),<br>        ElevatedButton(<br>          onPressed: _incrementCounter, //這裡呼叫 State 中設置好的 function，使得 _counter 變動（而不能直接輸入 &quot;_counter++&quot;）<br>          child: Text(&#39;Increment&#39;),<br>        ),<br>      ],<br>    );<br>  }<br>}</pre><h4>2. callback 調用並修改參數</h4><p>當按下按鈕後，我們想要修改其他圖片/文字的顯示。這邊簡單用 WidgetA 與 WidgetB 替代，來舉例如何在 WidgetB 中按下按鈕、進而使得 WidgetA 的文字改變：</p><pre>class MyStatefulWidget extends StatefulWidget { //當然要設置成 StatefulWdiget 啦。flutter 中輸入 “stf” 就會自動完成基本模板了。<br>  @override<br>  _MyStatefulWidgetState createState() =&gt; _MyStatefulWidgetState(); <br>}<br><br>class _MyStatefulWidgetState extends State&lt;MyStatefulWidget&gt; {<br>  int catIndex = 0; //在 State 中設置需要變動的參數<br>  void updateCatIndex(int newIndex) { //以及這個參數的變動程式。因為不需要回傳，故此 function 型別為 Void。<br>    setState(() { //將所需變動寫在 setState() 中<br>      catIndex = newIndex;<br>    });<br>  }<br><br>  @override<br>  Widget build(BuildContext context) { //建構畫面<br>    return Column(<br>      children: [<br>        WidgetA(index: catIndex),<br>        WidgetB(callFunction: updateCatIndex),<br>      ],<br>    );<br>  }<br>}<br><br></pre><p>當 WidgetB 中的按鈕按下後，需要呼叫 updateCatIndex(int)，故需要先把此 func 傳入此 Widget：</p><pre>class WidgetB extends StatelessWidget {<br>  final Function(int) callFunction; //設置相同格式的 function 型別參數，以傳入 State 中設置好的 updateCatIndex(int)<br><br>  WidgetB({required this.callFunction}); //設置此 WidgetB 的構造<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return ElevatedButton(<br>      onPressed: () {<br>        callFunction(100); // 呼叫 State 中的 updateCatIndex()，通知父級 widget 更新 catIndex &gt;&gt; 這邊會使得 catIndex 變成 100~<br>      },<br>      child: Text(&#39;Button&#39;),<br>    );<br>  }<br>}</pre><p>當父級 State 中的參數改變時，接收此參數的 WidgetA 就會相應的改變啦：</p><pre>class WidgetA extends StatelessWidget {<br>  final int index; //設置好參數以接收 catIndex<br><br>  WidgetA({required this.index}); //設置 Widget 構造<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Text(&#39;Cat Index: $index&#39;); // 會隨著 catIndex 變動而改變的文字<br>  }<br>}</pre><h4>3. Map</h4><p>Map 是很方便的數據儲存模式，可以儲存一連串的 Key 及相對應的 Value。會用到的一些用法筆記如下：</p><pre>//創建 Map<br>Map&lt;String, int&gt; scores = {&#39;Abby&#39;: 98, &#39;Bob&#39;: 90, &#39;Charlie&#39;: 78};<br><br>//讀取 value<br>int abbyScore = scores[&#39;Abby&#39;] ?? 0 //因為 scores[&#39;Abby&#39;] 可能為 null，故使用 ?? 設置預設值、或是用 ! 強制讀取。<br><br>//添加鍵值對<br>scores[&#39;ABBy&#39;] = 92; //如果 key 打錯字的話，Map 會自己新增項目 (亦即此時 scores 有 Abby 及 ABBy 兩組資料)<br><br>//修改 value<br>  if (scores[&#39;Abby&#39;] == null) { //如果 value 為null，則直接覆蓋<br>    scores[&#39;Abby&#39;] = 100;<br>  } else { <br>    //如果有找到對應的 key，則可以用 ! 強制讀取運算後重新儲存<br>    scores[&#39;Abby&#39;] = scores[&#39;Abby&#39;]! + 2;<br><br>    //或是使用 `??` 操作符提供默認值<br>    scores[&#39;Abby&#39;] = (scores[&#39;Abby&#39;] ?? 0) + 2;<br>  }<br><br>  // 或者使用 update 方法<br>  scores.update(&#39;Abby&#39;, (value) =&gt; value + 2, ifAbsent: () =&gt; 100);<br><br><br>//刪除鍵值對<br>scores.remove(&#39;Charlie&#39;);<br><br>//檢查鍵是否存在<br>bool hasElle = scores.containsKey(&#39;Elle&#39;);<br><br>//遍歷 Map<br>scores.forEach((key, value) { print(&#39;$key 的分數是 $value 分。&#39;); });<br><br>// 清空 Map<br>scores.clear();</pre><h4>4. (condition) ? true : false</h4><p>這個語法很方便，是 if (condition) { true } else { false }的簡化版。這邊既一下一些這次作業中用到的用法筆記：</p><pre>//找出 list 中最大的數：<br>int maxValue = myList.reduce((a, b) =&gt; a &gt; b ? a : b); //如果 a 大於 b 則返回 a 、反之則返回 b。reduce 會移除其他的直，於是最終剩下的會是最大的值<br><br>//根據條件判斷按鈕按下是否有作用：<br>onPressed: (opacityValue == 1) ? () =&gt; updateCatStatus() : null, //如果 opacityValue 等於 1 則運行 updateCatStatus()，反之則什麼都不做(null)<br><br>//忽略點擊事件<br>IgnorePointer(<br>    ignoring: (opacityValue == 0) ? true : false, //opacity等於零時忽略所有互動(ignoring = true)<br>    child: (...)<br>)</pre><h4>5. Opacity （使 Widget 不可見、但仍佔有空間）</h4><p>flutter 的排版定位方式都是根據相鄰 widget 排列所得來，因此當畫面上想要隱藏某個 widget 時，直接使用 Offstage 會導致畫面上其他 widgets 重新排版。而使用 Opacity（不透明度）就只是單純將 widget 轉為透明色，仍保有其所佔有的空間。</p><p>＊如果要隱藏的 widget 高度固定，也可以直接用 (condition) ? WidgetToHide() : ReplcaeWedget()來設置（ReplcaeWedget可以用PlaceHolder()/Container()/SizedBox()等來佔位。）</p><pre>Opacity(<br>  opacity: 0.0, // 型別為 double， 0.0 時則完全隱藏、 1.0 時完全顯示。<br>  child: YourWidget(),<br>)</pre><h4>6. Random()</h4><pre>import &#39;dart:math&#39;; //使用 Random() 需要 import &#39;dart:math&#39;這個 Library<br><br>void main() {<br>  Random random = Random();<br><br>  // 生成一個0到9之間的隨機整數（包含0，但不包含10）<br>  int randomInt = random.nextInt(10);<br><br>  // 生成一個隨機的布林值（true 或 false）<br>  bool randomBool = random.nextBool();<br><br>  // 生成一個0.0到1.0之間的隨機浮點數（包含0.0，但不包含1.0）<br>  double randomDouble = random.nextDouble();<br><br>}</pre><h4>7. Navigator</h4><p>其實這是上一個作業的筆記😆 不過前幾次作業都做得比較趕，這次就一起整理在這邊啦！</p><p>Navigator 是 Flutter 中用來管理路由（或稱為頁面）的工具。它負責在應用中切換不同的頁面，實現類似於在瀏覽器中前進或返回的功能。以下是 Navigator 的一些常見用法：</p><p><strong>🐾 推送新頁面（Push）</strong></p><pre>//push 方法可以將新頁面推送到當前頁面的上方，相當於將一個新的頁面壓入路由棧。<br>Navigator.push(<br>  context,<br>  MaterialPageRoute(builder: (context) =&gt; NewPage()),<br>);</pre><p><strong>🐾 推送並替換當前頁面（PushReplacement）</strong></p><pre>//pushReplacement 方法可以將新頁面推送到當前頁面的上方，並移除當前頁面。<br>Navigator.pushReplacement(<br>  context,<br>  MaterialPageRoute(builder: (context) =&gt; NewPage()),<br>);</pre><p><strong>🐾 返回上一頁（Pop）</strong></p><pre>//pop 方法可以返回到上一個頁面。<br>Navigator.pop(context);</pre><p><strong>🐾 傳遞數據給新頁面</strong></p><pre>//在推送頁面時傳遞數據給新頁面。<br>Navigator.push(<br>  context,<br>  MaterialPageRoute(<br>    builder: (context) =&gt; NewPage(<br>       data: &#39;Hello from HomePage&#39; //傳遞此字串至下一頁<br>    ),<br>  ),<br>);</pre><p><strong>🐾 命名路由</strong></p><pre>//自訂義每個路由名稱。<br>void main() {<br>  runApp(MaterialApp(<br>    initialRoute: &#39;/&#39;,<br>    routes: {<br>      &#39;/&#39;: (context) =&gt; HomePage(),<br>      &#39;/second&#39;: (context) =&gt; SecondPage(),<br>    },<br>  ));<br>}<br><br>//使用 Navigator 跳轉到命名路由：<br>Navigator.pushNamed(context, &#39;/second&#39;);</pre><p><strong>🐾 返回指定頁面</strong></p><pre>//使用 popUntil 返回到指定頁面。<br>Navigator.popUntil(context, ModalRoute.withName(&#39;/&#39;));<br><br>//返回到最初始頁面<br>Navigator.popUntil(context, (route) =&gt; route.isFirst);</pre><h4>8. 設置不同瀏覽器顯示比例</h4><p>因為一開始都是在 iphone 模擬器（直式）上進行設計，當後來使用 chrome 瀏覽器（橫式）時，會發現排版差距很大，甚至會出現空間不足的黃黑條紋的錯誤提示。</p><p>因此在設計畫面 widgets 尺寸時，我就直接使用模擬器的螢幕寬度作為比例尺啦、而當畫面變為橫式的時候，則會繼續以iphone15 的螢幕比例來顯示：</p><pre>class ScreenSize {<br>  final double standardLength;<br><br>  const ScreenSize({required this.standardLength});<br><br>  static double getStandardWidth(BuildContext context) { //在其他 widgets 中就可以用 ScreenSize.getStandardWidth(context) 來直接獲取適宜的寬度比例啦。<br>    final size = MediaQuery.of(context).size;<br>    double length = size.width;<br>    if (size.width &gt; size.height) {<br>      length = (size.height) / 852 * 393; //393*852 是 iphone15 模擬器的長寬尺寸～<br>    }<br>    return length;<br>  }<br>}</pre><p>使用 chrome 模擬器打開：(底部按鈕因為使用 Wrap wrap，就沒有設置 screenWidth 比例尺，空間足夠的情況下就直接一字排開啦～)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*j06gtKOT3Raa7AsFJ98rFw.png" /></figure><h4>9. deploy to github pages</h4><p>*terminal 指令來自 github🙏</p><ol><li>切換到 terminal，先測試一下網頁上運行沒有問題！</li></ol><pre>flutter run -d chrome</pre><p>2. 接下來準備建立 Web build 了</p><pre>flutter build web --base-href /appName/</pre><p>3. 第一次推送（main 分支）：<br>這步驟是將你的 Flutter 專案的源碼推送到 main 分支。這是專案的主要分支，用來儲存你的 Flutter 源碼和配置文件。</p><pre>git init<br>git add .<br>git remote add origin https://github.com/Pei-7/purr<br>git commit -m &quot;Init Project&quot;<br>git branch -M main<br>git push -u origin main</pre><p>4. 準備建立 gh-pages</p><pre>cd build/web</pre><p>5. 第二次推送（gh-pages 分支）：<br>這步驟是將 build/web 目錄中的編譯後的靜態檔案推送到 gh-pages 分支。GitHub Pages 使用這個分支來展示你的網站內容。</p><pre>git init<br>git checkout -b gh-pages<br>git add .<br>git commit -m &quot;Deploy to GitHub Pages&quot;<br>git remote add origin https://github.com/Pei-7/purr.git<br>git push -u origin gh-pages --force</pre><p>6. 推送成功後，到 github 頁面，點擊右上角 Setting &gt; Pages，在 Branch 的地方選擇 gh-pages 及 /(root) ，點擊 save，等幾分鐘後最上方就會出現建置好的網頁連結，點 “Visit site” 就會跳出發布好的網頁應用啦！💪</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*s014l8XUysEGoTUXhYvm7A.png" /></figure><h3>程式碼拆解</h3><h4>Enum 設置</h4><p>🐾 設置與動作按鈕相對應的圖片與文字：</p><pre>import &#39;dart:math&#39;;<br><br>enum Food {<br>  cherry(<br>    assetPath: &#39;food/cherry&#39;, //圖片檔案路徑<br>    description: &#39;貓貓吃了櫻桃。\n要小心不能把籽吞下去！&#39;, //圖片對應的說明<br>    keyName: &#39;saturation&#39;, //相對應的 Map Key名稱<br>    addValue: 1, //相對應的 Key value 要變更的數值<br>  ),<br>  pineApple(<br>    assetPath: &#39;food/pineApple&#39;,<br>    description: &#39;貓貓吃了鳳梨，並跟鳳梨打了一架。\n因為鳳梨咬了貓的舌頭。&#39;,<br>    keyName: &#39;saturation&#39;,<br>    addValue: 1,<br>  ),<br>  ......<br><br>  static Food getRandomOne() { //隨機出現一種食物。需要時直接呼叫 Food.getRandomOne() 即可。<br>    int index = Random().nextInt(Food.values.length);<br>    return Food.values[index];<br>  }<br>}</pre><h4>遊戲頁 CatPage</h4><p>＊其它頁面皆為 stateless widget，就不再贅述啦。</p><p><strong>🐾 初始設置</strong></p><pre>class CatPage extends StatefulWidget { //Stateful Widget!!<br>  const CatPage({super.key});<br><br>  @override<br>  State&lt;CatPage&gt; createState() =&gt; _CatHomeState();<br>}<br><br>Map&lt;int, String&gt; moodMap = { //撫摸按鈕會觸發的資料。這裡內容比較簡單，就不用 Enum 、而是直接用 Map 設置啦！<br>  1: &#39;貓貓很愉悅，\n並主動去找你的手蹭蹭。&#39;,<br>  2: &#39;貓貓很舒服，\n並發出呼嚕嚕的聲音。&#39;,<br>  3: &#39;貓貓覺得夠了。&#39;,<br>  4: &#39;貓貓要生氣了！&#39;,<br>  5: &#39;還摸！\n貓貓迅雷不及掩耳的咬了你一口。&#39;,<br>};<br><br>Map&lt;String, int&gt; pointing = { //儲存貓貓每個面向發展增加的數值，用以決定最終養成什麼樣的貓貓。<br>  &#39;exercise&#39;: 0,<br>  &#39;friendship&#39;: 0,<br>  &#39;saturation&#39;: 0,<br>  &#39;gift&#39;: 0,<br>  &#39;sleep&#39;: 0,<br>  &#39;world&#39;: 0,<br>  &#39;height&#39;: 0,<br>  &#39;spicy&#39;: 0,<br>  &#39;coffee&#39;: 0,<br>  &#39;mood&#39;: 0,<br>  &#39;mashroom&#39;: 0,<br>  &#39;ocean&#39;: 0<br>};<br><br>Map&lt;String, Result&gt; resultCorresponding = { //Map資料內容為 &lt;&#39;pointing key&#39; : &#39;result type&#39;&gt;，這幾種 pointing key 値最高，則會養出對應的貓貓。<br>  &#39;friendship&#39;: Result.friendship,<br>  &#39;saturation&#39;: Result.pig,<br>  &#39;gift&#39;: Result.gift,<br>  &#39;sleep&#39;: Result.koala,<br>  &#39;exercise&#39;: Result.tiger,<br>  &#39;world&#39;: Result.world,<br>};</pre><p><strong>🐾 State 設置️ 🚩🚩🚩</strong></p><p>把需要調用並更改的變數與 func 都設置在這邊！！</p><pre>class _CatHomeState extends State&lt;CatPage&gt; {<br>  //ButtonsTile 隱藏狀態<br>    double opacityValue = 1;<br><br>  //更改月份<br>  int calendarIndex = 0;<br>  void updateCalendarIndex() { //在 build 後皆須為 @immutable 內容，故與 calendarIndex 變化有關的程式碼皆統一設置在這邊<br>    setState(() {<br>      if (calendarIndex &lt; 12) {<br>          calendarIndex++; <br>          if (calendarIndex == 12) { //當 calendarInde+1變成12時，則設置 opacityValue 為 0 (要隱藏動作按鈕)<br>            opacityValue = 0;<br>          }<br>      } else { //超過12的話把數值都歸零<br>          calendarIndex = 0; <br>          pointing.updateAll((key, value) =&gt; 0);<br>      }<br>    });<br>  }<br><br>//asset檔名<br>  String assetName = &#39;cat_icon&#39;;<br>  void updateAssetName(String newName) { //後續在 build 中呼叫此 func 修改顯示圖片路徑<br>    setState(() {<br>      assetName = newName;<br>    });<br>  }<br><br>//description文字<br>  String descrptionText = &#39;&#39;;<br>  void updateDescrptionText(String newDescription) {//後續在 build 中呼叫此 func 修改顯示文字內容<br>    setState(() {<br>      descrptionText = newDescription;<br>    });<br>  }<br><br></pre><p><strong>🐾 Build 畫面</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WGZlbhbXPKqrnTddQ3XoXA.png" /></figure><pre>@override<br>  Widget build(BuildContext context) {<br>    return Scaffold(<br>      body: Container(<br>        alignment: Alignment.center,<br>        child: Column(<br>          mainAxisAlignment: MainAxisAlignment.center,<br>          children: [<br>            const Spacer(),<br>            Calendar(index: calendarIndex), //傳入 calendarIndex 值，使日期隨動作變更<br>            CatEmoji(assetName: assetName), //傳入 assetName 字串，使得圖片隨動作變更<br>            DescriptionText(text: descrptionText), //傳入 descriptionText 字串，使得文字隨動作變更<br>            const Spacer(),<br>            ButtonsTile( //傳入所需 function 與變數，於此 Widget 中呼叫用以變更其他 Widget 的顯示<br>              opacityValue: opacityValue,<br>              updateCalendarIndex: updateCalendarIndex,<br>              updateAssetName: updateAssetName,<br>              updateDescrptionText: updateDescrptionText,<br>            ),<br>          ],<br>        ),<br>      ),<br>    );<br>  }<br>}</pre><p><strong>&gt; Calendar(index: calendarIndex)</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/234/1*6CTjZsxkCeCrReAcpq23xA.png" /></figure><pre>class Calendar extends StatelessWidget {<br>  const Calendar({super.key, required this.index}); //設置要接收的變數參數<br><br>  final int index; //設置要接收的變數 index 型別<br><br>  @override<br>  Widget build(BuildContext context) {<br>    List&lt;String&gt; calendarList = [&#39;🗓️&#39;, &#39;❄️ Jan&#39;, &#39;❄️ Feb&#39;, &#39;🌸 Mar&#39;, &#39;🌸 Apr&#39;, &#39;🌸 May&#39;, &#39;🌻 Jun&#39;, &#39;🌻 Jul&#39;, &#39;🌻 Aug&#39;, &#39;🍁 Sep&#39;, &#39;🍁 Oct&#39;, &#39;🍁 Nov&#39;, &#39;❄️ Dec&#39;];<br>    return ClipRRect( //裁切圓角<br>      clipBehavior: Clip.hardEdge,<br>      borderRadius: BorderRadius.circular(24),<br>      child: Container(<br>        width: ScreenSize.getStandardWidth(context) * 0.3, //使用 screenWidth 作為比例尺以適應不同螢幕<br>        color: Colors.pink.shade100,<br>        padding: const EdgeInsets.all(8),<br>        child: Text(<br>          calendarList[index], //會隨傳入的 index 變化而改變顯示文字<br>          style: const TextStyle(<br>            fontSize: 18,<br>            fontWeight: FontWeight.bold,<br>          ),<br>          textAlign: TextAlign.center,<br>        ),<br>      ),<br>    );<br>  }<br>}</pre><p><strong>&gt; CatEmoji(assetName: assetName)</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/406/1*qfwO-7T0IjOvlJuEbN2dhg.png" /></figure><pre>class CatEmoji extends StatelessWidget {<br>  const CatEmoji({super.key, required this.assetName}); //設置要接收的變數參數<br><br>  final String assetName; //設置要接收的變數型別<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Container( //尺寸皆使用 screenWidth 作為比例尺以適應不同螢幕<br>      margin: EdgeInsets.symmetric(<br>          vertical: ScreenSize.getStandardWidth(context) * 0.12),<br>      width: ScreenSize.getStandardWidth(context) * 0.5,<br>      height: ScreenSize.getStandardWidth(context) * 0.5,<br>      child: Image.asset(&#39;assets/$assetName.png&#39;), //會隨傳入的 assetName 變化而改變顯示圖片路徑<br>    );<br>  }<br>}</pre><p><strong>&gt; DescriptionText(text: descrptionText)</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/464/1*m_p5EYGXG8eVMcJ6ydzR_A.png" /></figure><pre>class DescriptionText extends StatelessWidget {<br>  const DescriptionText({super.key, required this.text}); //設置要接收的變數參數<br><br>  final String text; //設置要接收的變數型別<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Column(<br>      children: [<br>        Container(<br>          alignment: Alignment.center,<br>          width: ScreenSize.getStandardWidth(context) * 0.85,<br>          height: 90,<br>          child: Text(<br>            text,<br>            style: const TextStyle(<br>              fontSize: 20,<br>            ),<br>            textAlign: TextAlign.center,<br>          ),<br>        ),<br>      ],<br>    );<br>  }<br>}</pre><p><strong>&gt; ButtonsTile(updateCalendarIndex: updateCalendarIndex, updateAssetName: updateAssetName, updateDescrptionText: updateDescrptionText, opacityValue: opacityValue, )</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/532/1*ov42URUQkaPdPY-5jCI3hg.png" /></figure><pre>class ButtonsTile extends StatelessWidget {<br>  //設置要接收的 func 參數<br>  const ButtonsTile({<br>    super.key,<br>    required this.updateCalendarIndex, <br>    required this.updateAssetName,<br>    required this.updateDescrptionText,<br>    required this.opacityValue,<br>  });<br><br>  //設置內部會呼叫到的 func 型別<br>  final Function updateCalendarIndex; <br>  final Function(String) updateAssetName;<br>  final Function(String) updateDescrptionText;<br>  final double opacityValue;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Stack( //使用 Stack 將 ResultButton 及 InteractiveButton 疊在一起（兩者不會同時顯示）<br>      children: [<br>        ResultButton(<br>          opacityValue: opacityValue,<br>          updateCalendarIndex: updateCalendarIndex,<br>        ),<br>        InteractiveButtons(<br>          opacityValue: opacityValue,<br>          updateCalendarIndex: updateCalendarIndex,<br>          updateAssetName: updateAssetName,<br>          updateDescrptionText: updateDescrptionText,<br>        ),<br>      ],<br>    );<br>  }<br>}<br></pre><p><strong>&gt;&gt; InteractiveButtons</strong></p><pre>class InteractiveButtons extends StatelessWidget {<br>  const InteractiveButtons({<br>    super.key,<br>    required this.opacityValue,<br>    required this.updateCalendarIndex,<br>    required this.updateAssetName,<br>    required this.updateDescrptionText,<br>  });<br><br>  final double opacityValue;<br>  final Function updateCalendarIndex;<br>  final Function(String p1) updateAssetName;<br>  final Function(String p1) updateDescrptionText;<br><br>  @override<br>  Widget build(BuildContext context) {<br><br>    List&lt;ActionItem&gt; actionItems = [ //共要設置五個按鈕<br>      ActionItem.eat,<br>      ActionItem.pat,<br>      ActionItem.sleep,<br>      ActionItem.play,<br>      ActionItem.explore,<br>    ];<br><br>    return Center(<br>      child: Opacity(<br>        opacity: opacityValue, //使用設置在 State 中的 opacityValue，使這個不透明度可以隨動作切換<br>        child: IgnorePointer(<br>          ignoring: (opacityValue == 0) ? true : false, //opacity等於零時忽略所有互動<br>          child: Container(<br>            padding: const EdgeInsets.only(bottom: 48.0),<br>            child: Wrap(<br>              alignment: WrapAlignment.center, //使用 Wrap，會視可用空間自動換行<br>              spacing: 16,<br>              children: [<br>                for (var action in actionItems)//用 for 迴圈設置五個按鈕<br>                  CatAction( //CatAction widget 詳情見下方↓<br>                    action: action,<br>                    updateCalendarIndex: updateCalendarIndex,<br>                    updateAssetName: updateAssetName,<br>                    updateDescrptionText: updateDescrptionText,<br>                    opacityValue: opacityValue,<br>                  ),<br>              ],<br>            ),<br>          ),<br>        ),<br>      ),<br>    );<br>  }<br>}<br><br><br><br>//CatAction:<br>class CatAction extends StatelessWidget {<br>  const CatAction({<br>    super.key,<br>    required this.action,<br>    required this.updateCalendarIndex,<br>    required this.updateAssetName,<br>    required this.updateDescrptionText,<br>    required this.opacityValue,<br>  });<br><br>  final ActionItem action;<br>  final Function updateCalendarIndex; <br>  final Function(String) updateAssetName;<br>  final Function(String) updateDescrptionText;<br>  final double opacityValue;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return SizedBox(<br>      width: ScreenSize.getStandardWidth(context) * 0.24,<br>      height: ScreenSize.getStandardWidth(context) * 0.24,<br>      child: ElevatedButton(<br>        style: ElevatedButton.styleFrom( //設置 ElevatedButton 樣式<br>          elevation: 4,<br>          backgroundColor: Colors.pink.shade100,<br>          padding: EdgeInsets.zero, //ElevatedButton好像原本有自帶 padding，導致上面的emoji無法置中，故手動設定為 .zero<br>        ),<br>        onPressed: (opacityValue == 1) ? () =&gt; updateCatStatus() : null, //當不透明度為 1(顯示)時，運行 updateCatStatus()。反之（隱形時）則不動作。<br>        child: Center(<br>          child: Text(<br>            action.emoji,<br>            style: const TextStyle(fontSize: 42),<br>            textAlign: TextAlign.center,<br>          ),<br>        ),<br>      ),<br>    );<br>  }<br><br><br>  //updateCatStatus<br>  void updateCatStatus() {<br>    updateCalendarIndex();<br><br>    if (action == ActionItem.eat) { //當按下食物按鈕時<br>      Food newFood = Food.getRandomOne();//隨機出現一種食物<br>      updateAssetName(newFood.assetPath); //更新顯示圖片路徑<br>      updateDescrptionText(newFood.description); //更新顯示文字<br>      pointing[newFood.keyName] =<br>          (pointing[newFood.keyName] ?? 0) + newFood.addValue; //更新貓貓成長數值<br><br>    } else if (action == ActionItem.explore) { //當按下探險按鈕時<br>      //類同上，略<br><br>    } else if (action == ActionItem.play) { //當按下遊玩按鈕時<br>      //類同上，略<br><br>    }else if (action == ActionItem.pat) { //當按下撫摸按鈕時<br>      if (pointing[&#39;mood&#39;]! &lt; 5) { //使 mood value 最高值為 5<br>        pointing[&#39;mood&#39;] = pointing[&#39;mood&#39;]! + 1;<br>      } else {<br>        pointing[&#39;mood&#39;] = 5;<br>      }<br>      updateAssetName(&#39;mood/mood${pointing[&#39;mood&#39;]}}&#39;); //更新顯示圖片路徑<br>      updateDescrptionText(moodMap[pointing[&#39;mood&#39;]]!); //更新顯示文字<br><br>    } else if (action == ActionItem.sleep) { //當按下睡覺按鈕時<br>      updateAssetName(&#39;sleep&#39;); //更新顯示圖片路徑<br>      updateDescrptionText(&#39;貓貓呼呼大睡。&#39;); //更新顯示文字<br>      pointing[&#39;sleep&#39;] = (pointing[&#39;sleep&#39;] ?? 0) + 1; //更新貓貓睡眠值<br>    }<br>  }<br>}<br><br></pre><p><strong>&gt;&gt; ResultButton</strong></p><pre>class ResultButton extends StatelessWidget {<br>  const ResultButton({<br>    super.key,<br>    required this.opacityValue,<br>    required this.updateCalendarIndex,<br>  });<br><br>  final double opacityValue;<br>  final Function updateCalendarIndex;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Center(<br>        child: Opacity(<br>      opacity: opacityValue == 1 ? 0 : 1, //ResultButton 的隱藏與 InteractiveButtons 剛好相反<br>      child: FilledButton(<br>          onPressed: (opacityValue == 0) ? () =&gt; showResult(context) : null, //opacity等於 0 時運行 showResult(context)，反之則不動作<br>          child: Padding(<br>            padding: const EdgeInsets.symmetric(vertical: 32.0),<br>            child: Column(<br>              children: [<br>                SizedBox(<br>                    width: ScreenSize.getStandardWidth(context) * 0.18,<br>                    height: ScreenSize.getStandardWidth(context) * 0.18,<br>                    child: Image.asset(&#39;assets/unsure.png&#39;)),<br>                const Text(&quot;查看養成貓貓&quot;, style: TextStyle(fontSize: 18)),<br>              ],<br>            ),<br>          )),<br>    ));<br>  }<br><br><br>//showResult(context)<br>  void showResult(BuildContext context) {<br>    // 找到 pointing map 前六項中最高的數值<br>    List&lt;int&gt; values = pointing.values.toList();<br>    List&lt;int&gt; firstSixValues = values.sublist(0, 6);<br>    int maxValue = firstSixValues.reduce((a, b) =&gt; a &gt; b ? a : b);<br><br>    // 找到最高值所對應的 key（謝謝 chatGPT 給出的程式碼🙏，這一段我還不太懂）<br>    String? keyOfMaxValue = pointing.entries.firstWhere(<br>      (entry) =&gt; entry.value == maxValue, orElse: () =&gt; const MapEntry(&#39;&#39;, 0)<br>    ).key;<br><br>    //貓貓養成的結局<br>    Result catResultName = Result.tiger; //先隨便預設一個值<br><br>    if (resultCorresponding[keyOfMaxValue] != null) { //先檢查確認 &#39;keyOfMaxValue&#39; value 存在<br>      catResultName = resultCorresponding[keyOfMaxValue]!; //依據最高數值的 key 得出貓貓養成的結局<br>    }<br><br><br>    if (pointing[&#39;sleep&#39;]! &gt; 6) { //有些比較特別的養成結果一一設置<br>      catResultName = Result.koala;<br>    }<br><br>   ...//類同上，略<br><br><br>    Navigator.push( //得出結局之後，將結局傳至下一頁並跳轉<br>      context,<br>      MaterialPageRoute(<br>        builder: (context) =&gt; ResultPage(<br>          catResult: catResultName,<br>        ),<br>      ),<br>    );<br>    updateCalendarIndex(); //更新 calendarIndex（使之歸零）<br>  }<br>}<br><br></pre><p>＊貓貓圖片皆來自於 Google Emoji Kitchen:</p><p><a href="https://www.google.com/search?q=google+emoji+kitchen&amp;rlz=1C5CHFA_enTW973TW973&amp;oq=googl&amp;gs_lcrp=EgZjaHJvbWUqBggAEEUYOzIGCAAQRRg7Mg0IARAuGMcBGNEDGIAEMgcIAhAAGIAEMgYIAxBFGDwyBggEEEUYPDIGCAUQRRg8MgYIBhBFGDwyBggHEAUYQNIBCDI4NDFqMGo3qAIAsAIA&amp;sourceid=chrome&amp;ie=UTF-8">google emoji kitchen - Google Search</a></p><h3>GitHub 連結</h3><p><a href="https://github.com/Pei-7/purr">GitHub - Pei-7/purr</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a2f4c427a387" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-07-%E8%B2%93%E8%B2%93%E9%A4%8A%E6%88%90%E5%B0%8F%E9%81%8A%E6%88%B2-a2f4c427a387">Flutter作業#07 — 貓貓養成小遊戲🐈</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Flutter作業#06 — 電子書 <<Duffy and Friends>>]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-06-%E9%9B%BB%E5%AD%90%E6%9B%B8-duffy-and-friends-d7f891e8a813?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/d7f891e8a813</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Tue, 13 Aug 2024 09:49:56 GMT</pubDate>
            <atom:updated>2024-08-13T15:16:18.574Z</atom:updated>
            <content:encoded><![CDATA[<h3>Flutter作業#06 — 電子書</h3><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84%E8%A9%A6%E7%85%89-%E5%8B%87%E8%80%85%E7%9A%84-100-%E9%81%93-swift-ios-app-%E8%AC%8E%E9%A1%8C/218-flutter-%E5%A4%9A%E9%A0%81%E9%9D%A2%E9%9B%BB%E5%AD%90%E6%9B%B8-app-62ed576882ec">#218 Flutter 多頁面電子書 App</a></p><pre>目錄<br><br>  <a href="#e148">成品 gif</a><br>  <a href="#3880">自定義 class 與 enum</a><br>  <a href="#ff02">首頁 (GridView, GestureDetector 及 Navigator)</a><br>  <a href="#13f1">內頁 (TabBar, ListView 及 Card)</a><br>  <a href="#05ad">github</a></pre><h3>成品 gif</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/322/1*LmYf_sZnhDAKCPDN22mwIw.gif" /></figure><h3>自定義 class 與 enum</h3><h4>1. class DuffyFriends</h4><p>自定義 Duffy and friends 角色的 Class 並宣告七個角色的內容：</p><pre>class DuffyFriends {<br>  //型別<br>  final String fileName;<br>  final String name;<br>  final String story;<br>  final String gender;<br>  final String characteristics;<br>  final String personality;<br>  final String hobby;<br><br>  //構造<br>  const DuffyFriends({<br>    required this.fileName,<br>    required this.name,<br>    required this.story,<br>    required this.gender,<br>    required this.characteristics,<br>    required this.personality,<br>    required this.hobby,<br>  });<br><br><br>  //創建角色<br>  static const DuffyFriends duffy = DuffyFriends( //跟 swift 一樣，class 內宣告實例也要加 static<br>    fileName: &#39;duffy&#39;,<br>    name: &#39;達菲 Duffy&#39;,<br>    story:<br>        &quot;&quot;&quot;有一天，米奇即將揚帆遠航到世界各地冒險，米妮親手縫製了一隻玩具熊送給米奇，好讓他在旅程中不會感到孤單。由於米奇實在喜歡這隻小熊，甚至希望能和他一起散步，所以後來奇妙仙子便賦予了達菲熊生命。達菲成為米奇環遊世界的夥伴，一同遊歷各地名勝古蹟，在路途上認識不少新朋友。<br>達菲有些單純也有一點害羞。 雖然有時會猶豫要不要挑戰新事物，但是會在雪莉玫和其他朋友的鼓舞下學習新事物。&quot;&quot;&quot;,<br>    gender: &#39;男&#39;,<br>    characteristics: &#39;腳掌和屁股上有著米奇形狀的印記&#39;,<br>    personality: &#39;害羞&#39;,<br>    hobby: &#39;旅遊，拍照，認識新朋友&#39;,<br>  );<br><br>  ...... //依照相同格式設置其他六位角色。以下略。<br><br>}</pre><h4>2. enum IconSet</h4><p>預先設置在製作角色介紹表格時會用到的 icon heading 樣式：</p><pre>enum IconSet {<br>  gender(Icons.account_circle, &#39;性別&#39;, Colors.red),<br>  characteristic(Icons.stars, &#39;特徵&#39;, Colors.orange),<br>  personality(Icons.mood, &#39;性格&#39;, Colors.green),<br>  hobby(Icons.recommend, &#39;愛好&#39;, Colors.blue);<br><br>  //定義屬性<br>  final IconData iconName;<br>  final String iconTitle;<br>  final Color iconColor;<br><br>  //構造函數<br>  const IconSet(this.iconName, this.iconTitle, this.iconColor);<br>}</pre><h3>首頁</h3><p>&gt; 練習 GridView, GestureDetector 及 Navigator</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RCKz3SA0qbxq4dzhA-pUYQ.png" /></figure><pre>void main() {<br>  runApp(const MainApp());<br>}<br><br>class MainApp extends StatelessWidget {<br>  const MainApp({super.key});<br>  @override<br>  Widget build(BuildContext context) {<br>    return MaterialApp(<br>      home: Scaffold(<br>        appBar: AppBar(<br>          title: const BarTitle(),<br>        ),<br>        body: const DuffyGridView(),<br>      ),<br>    );<br>  }<br>}</pre><h4>- BarTitle</h4><pre>class BarTitle extends StatelessWidget {<br>  const BarTitle({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return const Text(<br>      &#39;Duffy and Friends&#39;,<br>      style: TextStyle(<br>        fontWeight: FontWeight.bold,<br>      ),<br>    );<br>  }<br>}</pre><h4>- DuffyGridView</h4><pre>List&lt;DuffyFriends&gt; characters = [ //先設置角色排序 List，方便後續 for 迴圈呼叫<br>  DuffyFriends.duffy,<br>  DuffyFriends.shellieMay,<br>  DuffyFriends.gelatoni,<br>  DuffyFriends.stellaLou,<br>  DuffyFriends.cookieAnn,<br>  DuffyFriends.oluMel,<br>  DuffyFriends.linabell,<br>];<br><br>class DuffyGridView extends StatelessWidget {<br>  const DuffyGridView({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Padding(<br>      padding: const EdgeInsets.all(8.0),<br>      child: GridView.builder( //雖然只有七個 item，這邊還是使用了 GridView.builder 來練習～ （＊builder 會等畫面滾動到時再生成 item 以增進整體效能）<br>        gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(<br>          crossAxisCount: 2, //橫向item數量<br>          mainAxisSpacing: 10, //此 GridView 為縱向滾動，故這邊的 mainAxisSpacing 為設定縱向的間隔寬度<br>          crossAxisSpacing: 10,//橫向的間隔寬度<br>        ),<br>        itemCount: characters.length, //設置總 item 數量。這邊沒有設置的話，GirdView 會有無限延伸的格數！（無資料的 item 會顯示為紅底的錯誤提示 Range Error)<br>        itemBuilder: (context, index) {<br>          return TapNavigate(index: index); //自定義 widget TapNavigate 見下段<br>        },<br>      ),<br>    );<br>  }<br>}</pre><h4>- TapNavigate</h4><pre>class TapNavigate extends StatelessWidget {<br>  final int index;<br>  const TapNavigate({<br>    super.key,<br>    required this.index,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return GestureDetector( //使用 GestureDetector 來偵測點擊<br>      onTap: () { //點擊後的動作<br>        Navigator.push( //push 跳轉至下一頁<br>          context,<br>          MaterialPageRoute(<br>              builder: (context) =&gt; CharactorDetails( //＊呼叫第二頁的 class CharactorDetails<br>                    character: characters[index], //傳遞要顯示的角色資料<br>                  )),<br>        );<br>      },<br>      child: GridImage(index: index), //設置每個 Grid 內顯示的圖片。詳細程式碼見下段。<br>    );<br>  }<br>}</pre><h4>- GridImage</h4><pre>class GridImage extends StatelessWidget {<br>  const GridImage({<br>    super.key,<br>    required this.index,<br>  });<br><br>  final int index;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return ClipRRect( //設置圓角<br>      borderRadius: BorderRadius.circular(18),<br>      child: Image.asset(<br>          &#39;assets/${characters[index].fileName}.jpg&#39; //＊給自己的小提醒：字符串插值使用 ${} 讀取，不是 $()。還有結尾記得加 .jpg!!!<br>          ),<br>    );<br>  }<br>}</pre><h3>內頁</h3><p>&gt; 練習 TabBar, ListView 及 Card</p><pre>import &#39;package:ebook_duffy_friends/duffy_friends.dart&#39;;<br>import &#39;package:ebook_duffy_friends/icon_set.dart&#39;;<br>import &#39;package:flutter/material.dart&#39;;<br><br>class CharactorDetails extends StatelessWidget {<br>  final DuffyFriends character; //設置會從上一頁接收到的值（DuffyFriends 型別）<br><br>  const CharactorDetails({super.key, required this.character});<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return DefaultTabController( //設置 TabBar<br>      length: 3, //設置三個 Tabs<br>      child: Scaffold(<br>        //＊＊＊非首頁不用設置 MaterialApp，避免 navigator 被重新創建而無法出現&quot;返回&quot;按鈕。<br>        appBar: AppBar(<br>          title: Text(character.name), // app bar上顯示角色名字<br>          bottom: const TabBar(<br>            tabs: [ //設置三個 Tab 的標題<br>              Tab(text: &#39;故事背景&#39;),<br>              Tab(text: &#39;角色設定&#39;),<br>              Tab(text: &#39;圖庫&#39;),<br>            ],<br>          ),<br>        ),<br>        body: TabBarView( //設置每一個 Tab 對應的內容<br>          children: [<br>            StoryTab(character: character), //&#39;故事背景&#39;頁面。詳細程式碼見下段。<br>            ListTab(character: character), //&#39;角色設定&#39;頁面。詳細程式碼見下下段。<br>            GalleryTab(character: character), //&#39;圖庫&#39;頁面。詳細程式碼見下下下段。<br>          ],<br>        ),<br>      ),<br>    );<br>  }<br>}</pre><h4>- StoryTab</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*n4MfeJ53MXP_lp10_y5Peg.png" /></figure><pre>class StoryTab extends StatelessWidget {<br>  const StoryTab({<br>    super.key,<br>    required this.character,<br>  });<br><br>  final DuffyFriends character;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return SingleChildScrollView(<br>      child: Column(<br>        children: [<br>          Container( <br>            width: 320,<br>            height: 320,<br>            padding: const EdgeInsets.only(top: 24), //僅設置與上方間距<br>            child: CircleAvatar( //設置角色大頭照<br>                foregroundImage:<br>                    AssetImage(&#39;assets/${character.fileName}.jpg&#39;)),<br>          ),<br>          Padding(<br>            padding: const EdgeInsets.all(24.0),<br>            child: Text(<br>              character.story, //顯示角色故事<br>              style: const TextStyle(<br>                fontSize: 18,<br>              ),<br>            ),<br>          ),<br>        ],<br>      ),<br>    );<br>  }<br>}</pre><h4>- ListTab</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qhZjaBdUGVAS1npEbngxzA.png" /></figure><pre>List&lt;IconSet&gt; icons = [ //先設置好 IconSet List 以便後續 for 迴圈依次生成<br>  IconSet.gender,<br>  IconSet.characteristic,<br>  IconSet.personality,<br>  IconSet.hobby,<br>];<br><br>class ListTab extends StatelessWidget {<br>  const ListTab({<br>    super.key,<br>    required this.character,<br>  });<br><br>  final DuffyFriends character;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    List&lt;String&gt; characterDetails = [ //設置好 String List 以便後續 for 迴圈依次生成<br>      character.gender,<br>      character.characteristics,<br>      character.personality,<br>      character.hobby,<br>    ];<br><br>    return ListView.separated( //想要設置帶有分隔線的 ListView，故使用 .separated<br>      itemCount: 4, //資料筆數<br>      itemBuilder: (context, index) {<br>        return ListRow( //自定義 Widget ListRow 詳細程式碼見下方。<br>          index: index,<br>          characterDetails: characterDetails,<br>        );<br>      },<br>      separatorBuilder: (context, index) =&gt; const Divider(), //設置分隔線<br>    );<br>  }<br>}<br><br><br>//自定義 Widget ListRow<br>class ListRow extends StatelessWidget {<br>  const ListRow({<br>    super.key,<br>    required this.index,<br>    required this.characterDetails,<br>  });<br><br>  final int index;<br>  final List&lt;String&gt; characterDetails;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    IconSet iconHeading = icons[index];<br>    return Row(<br>      children: [<br>        Padding(<br>          padding: const EdgeInsets.symmetric( //設置對稱的內部間距<br>            vertical: 10, //top &amp; bottom<br>            horizontal: 16, //leading &amp; trailing<br>          ),<br>          child: ListHeading( //自定義 Widget ListHeading 詳細程式碼見下方。<br>            rowIcon: iconHeading.iconName, <br>            rowName: iconHeading.iconTitle,<br>            iconColor: iconHeading.iconColor,<br>          ),<br>        ),<br>        Expanded( //使用 Expanded 使得文字填滿整個可用空間並能自動換行<br>          child: Padding(<br>            padding: const EdgeInsets.symmetric(<br>              vertical: 10,<br>              horizontal: 16,<br>            ),<br>            child: Text(<br>              characterDetails[index],<br>              style: const TextStyle(<br>                fontSize: 18,<br>              ),<br>            ),<br>          ),<br>        ),<br>      ],<br>    );<br>  }<br>}<br><br>//ListHeading<br>class ListHeading extends StatelessWidget {<br>  final IconData rowIcon;<br>  final String rowName;<br>  final Color iconColor;<br><br>  const ListHeading({<br>    super.key,<br>    required this.rowIcon,<br>    required this.rowName,<br>    required this.iconColor,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Column(<br>      children: [<br>        Icon(<br>          rowIcon, //設置 icon 圖示<br>          size: 36,<br>          color: iconColor,<br>        ),<br>        Text(rowName), //設置對應文字標示<br>      ],<br>    );<br>  }<br>}</pre><h4>- GalleryTab</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XGIrFjqEaAxh5CBnkEyLRQ.jpeg" /></figure><pre>class GalleryTab extends StatelessWidget {<br>  const GalleryTab({<br>    super.key,<br>    required this.character,<br>  });<br><br>  final DuffyFriends character;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return SingleChildScrollView(<br>      child: Column(<br>        children: [<br>          for (var i = 1; i &lt;= 4; i++) //使用 for 迴圈生成四張 Cards<br>            GalleryCards( //自定義 Widget GalleryCards，相係程式碼見下方。 <br>              character: character,<br>              index: i,<br>            ),<br>        ],<br>      ),<br>    );<br>  }<br>}<br><br>//自定義 Widget GalleryCards<br>class GalleryCards extends StatelessWidget {<br>  const GalleryCards({<br>    super.key,<br>    required this.character,<br>    required this.index,<br>  });<br><br>  final DuffyFriends character;<br>  final int index;<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Card(<br>      elevation: 8, //設置高度用以顯示陰影效果<br>      margin: const EdgeInsets.all(16),<br>      clipBehavior:<br>          Clip.hardEdge, //Card 雖然預設圓角，但是不會改變 child 圖片形狀，故要手動設置 clip 以裁切內部圖片<br>      child: Image.asset(&#39;assets/${character.fileName}$index.jpg&#39;),<br>    );<br>  }<br>}</pre><h3>github</h3><p><a href="https://github.com/Pei-7/ebook_duffy_friends">GitHub - Pei-7/ebook_duffy_friends</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d7f891e8a813" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-06-%E9%9B%BB%E5%AD%90%E6%9B%B8-duffy-and-friends-d7f891e8a813">Flutter作業#06 — 電子書 &lt;&lt;Duffy and Friends&gt;&gt;</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Flutter作業#05 — 製作 about 頁面(2)]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-05-%E8%A3%BD%E4%BD%9C-about-%E9%A0%81%E9%9D%A2-2-604c0478d807?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/604c0478d807</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Wed, 07 Aug 2024 10:09:06 GMT</pubDate>
            <atom:updated>2024-08-07T10:39:44.964Z</atom:updated>
            <content:encoded><![CDATA[<h3>Flutter作業#05 — 製作 about 頁面(2)</h3><p>作業：打造吸睛的 About 頁面 進階版</p><p>- 加入 const<br>- 自訂 widget constructor <br>- 搭配自訂的資料型別<br>- 包含多個檔案<br>- 使用 collection for 顯示 List 的資料</p><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84%E8%A9%A6%E7%85%89-%E5%8B%87%E8%80%85%E7%9A%84-100-%E9%81%93-swift-ios-app-%E8%AC%8E%E9%A1%8C/211-%E6%89%93%E9%80%A0%E5%90%B8%E7%9D%9B%E7%9A%84-about-%E9%A0%81%E9%9D%A2-7caca09d5131">#211 打造吸睛的 About 頁面</a></p><p>這一週比較忙🙈 好險在上課前一小時把這週的作業做完啦！這次使用新學的語法做了跟上次的作業做成相同的頁面，看了最後的對比圖，覺得自己有慢慢在進步啦💪</p><p>實在太趕了 GitHub 連結下次再補～🙏</p><pre><a href="#72bb">成品 gif</a><br><a href="#9c3a">設置 enum files</a><br><a href="#9942">各 widget/ method 拆分</a><br><a href="#2ad2">完整頁面拼接</a><br><a href="#8078">兩週作業比較</a></pre><h3>成品 gif</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/324/1*x2rwJ7o4nYSWBPs94gCfcA.gif" /></figure><h3>設置 enum files</h3><ol><li>角色資料 enum：</li></ol><pre>enum ShellieMay {<br>  name(&#39;雪莉玫 ShellieMay&#39;),<br>  description(<br>      &#39;有了達菲陪伴米奇環遊世界後，米妮又特意為達菲製作新的朋友，於是邊有了雪梨玫，後來達菲更與雪梨玫成為了好朋友。她和達菲一樣頭又著和米奇一樣的形狀，擁有粉紅色毛髮，是達菲熊家族第二個出現的角色。&#39;),<br>  gender(&#39;女&#39;),<br>  characteristic(&#39;長長的睫毛，藍色眼睛，頭戴蝴蝶結，腳掌和屁股上有著米奇形狀的印記&#39;),<br>  personality(&#39;樂觀開朗&#39;),<br>  hobby(&#39;旅遊，打扮，認識新朋友&#39;); // 這裡要記得加上分號!!<br><br>  //定義屬性<br>  final String inputText;<br><br>  //構造函數<br>  const ShellieMay(this.inputText);<br>}</pre><p>2. 表格欄位的圖標 enum</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/766/1*zc5y9BO_77oQNLm98PwCxQ.png" /></figure><pre>enum IconSet {<br>  gender(Icons.account_circle, &#39;性別&#39;, Colors.red),<br>  characteristic(Icons.stars, &#39;特徵&#39;, Colors.orange),<br>  personality(Icons.mood, &#39;性格&#39;, Colors.green),<br>  hobby(Icons.recommend, &#39;愛好&#39;, Colors.blue);<br><br>  //定義屬性<br>  final IconData iconName;<br>  final String iconTitle;<br>  final Color iconColor;<br><br>  //構造函數<br>  const IconSet(this.iconName, this.iconTitle, this.iconColor);<br>}</pre><p>其實原本的 enum 都是直接打在 main.dart 裡的，寫完之後選擇 enum 名稱，就會自動出現小燈泡選項 “Move ‘IconSet’ to file” ：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1006/1*8OHnb0mMzv46W2FRJ3Pslw.png" /></figure><p>選擇之後，就會自動整理成 .dart 檔案，並且在原本的 main.dart 中自動 import 啦！</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RNNVyByfPYx-OLgPdcCjIg.png" /></figure><h3>各 widget 拆分</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sJ3skmrQGMujzUMhh304KQ.png" /></figure><p>BarTitle()</p><pre>class BarTitle extends StatelessWidget {<br>  const BarTitle({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Text(<br>      ShellieMay.name.inputText, //這裡呼叫自定義的 enum ShellieMay<br>      style: const TextStyle(<br>        fontWeight: FontWeight.bold,<br>      ),<br>    );<br>  }<br>}</pre><p>Background()</p><pre>class Background extends StatelessWidget {<br>  const Background({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Container(<br>      constraints: const BoxConstraints.expand(), //使 child widget 對齊 parent widget 四邊<br>      child: Opacity(<br>        opacity: 0.24, //調整透明度<br>        child: Image.asset(<br>          &#39;assets/background.jpg&#39;, //設置圖片的時候，如果模擬器上顯示&quot;Asset not found&quot; hot reload 可能跑不出來（會），要記得手動刷新～ <br>          fit: BoxFit.cover,<br>        ),<br>      ),<br>    );<br>  }<br>}</pre><p>Avatar()</p><pre>class Avatar extends StatelessWidget {<br>  const Avatar({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return const SizedBox(<br>      width: 320,<br>      height: 320,<br>      child: CircleAvatar( //自動生成圓形圖片<br>        foregroundImage: AssetImage(<br>          &#39;assets/avatar/shellieMay.jpg&#39;,<br>        ),<br>      ),<br>    );<br>  }<br>}</pre><p>Description()</p><pre>class Description extends StatelessWidget {<br>  const Description({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Text(<br>      ShellieMay.description.inputText,  //呼叫自定義的 enum ShellieMay<br>      style: const TextStyle(<br>        fontSize: 18,<br>      ),<br>    );<br>  }<br>}</pre><p>DetailsTable()</p><p>用這週新學了 Table Widget 來取代原本使用的 Divider() 和 SizedBox() ：</p><pre>//先設置兩組 List 以便後續生成時使用 for 迴圈依次呼叫。<br>List&lt;IconSet&gt; icons = [<br>  IconSet.gender,<br>  IconSet.characteristic,<br>  IconSet.personality,<br>  IconSet.hobby<br>];<br>List&lt;ShellieMay&gt; character = [<br>  ShellieMay.gender,<br>  ShellieMay.characteristic,<br>  ShellieMay.personality,<br>  ShellieMay.hobby<br>];<br><br><br>class DetailsTable extends StatelessWidget {<br>  const DetailsTable({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Table(<br>      border: const TableBorder( //設置表格框線<br>        horizontalInside: BorderSide( //僅設置表格內部水平線<br>          color: Colors.grey,<br>          width: 1.2,<br>        ),<br>      ),<br>      columnWidths: { //設置兩欄的寬度比例<br>        0: FractionColumnWidth(1 / 6),<br>        1: FractionColumnWidth(5 / 6),<br>      },<br>      children: [ <br>        for (var i = 0; i &lt;= 3; i++) //使用 for 迴圈重複四次生成 row 的 method。for 內部記得要用 “;” 分隔！！<br>          buildTableRow( //自訂的 buildTableRow() *完整程式碼見下方~<br>            iconSet: icons[i], //自訂參數傳入自訂的 enum IconSet<br>            character: character[i], //自訂參數傳入自訂的 enum ShellieMay<br>          )<br>      ],<br>    );<br>  }<br>}<br><br><br>//method: buildTableRow()<br>TableRow buildTableRow({<br>  required IconSet iconSet, //設置必填的命名參數<br>  required ShellieMay character,<br>}) {<br>  return TableRow(<br>    children: [<br>      TableCell(<br>        verticalAlignment: TableCellVerticalAlignment.middle, //tableCell 內部垂直置中對齊<br>        child: Padding(<br>          padding: const EdgeInsets.all(4.0),<br>          child: RowTitle( //自訂的 widget RowTitle() *完整程式碼見下方<br>            rowIcon: iconSet.iconName, // iconSet 參數型別為自訂的 enum IconSet<br>            rowName: iconSet.iconTitle,<br>            iconColor: iconSet.iconColor,<br>          ),<br>        ),<br>      ),<br>      TableCell(<br>        verticalAlignment: TableCellVerticalAlignment.middle,<br>        child: Padding(<br>          padding: const EdgeInsets.all(8.0),<br>          child: Text(<br>            character.inputText, //character 參數型別為自訂的 enum ShellieMay<br>            style: TextStyle(<br>              fontSize: 18,<br>            ),<br>          ),<br>        ),<br>      ),<br>    ],<br>  );<br>}<br><br><br>//widget: RowTitle()<br>class RowTitle extends StatelessWidget { <br>  IconData rowIcon; //設置內部參數的各個型別<br>  String rowName;<br>  Color iconColor;<br><br>  RowTitle({ <br>    required this.rowIcon, //設置必填的命名參數<br>    required this.rowName,<br>    required this.iconColor,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Column(<br>      children: [<br>        Icon(<br>          rowIcon,<br>          size: 36,<br>          color: iconColor,<br>        ),<br>        Text(rowName),<br>      ],<br>    );<br>  }<br>}</pre><p>Gallery()</p><pre>class Gallery extends StatelessWidget {<br>  const Gallery({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Container(<br>      margin: EdgeInsets.only(bottom: 48), //設置 container 底部與外的距離（取代原本的 SizedBox 手動設置間距）<br>      child: SingleChildScrollView( <br>        scrollDirection: Axis.horizontal, //設置橫向滑動的 scrollView<br>        child: SizedBox(<br>          width: 810,<br>          child: Row(<br>            mainAxisAlignment: MainAxisAlignment.spaceBetween,<br>            children: [ //使用 for 迴圈設置三次相同格式的圖片。<br>              for (var i = 1; i &lt;= 3; i++) setGalleryItem(i), //自訂的 method setGalleryItem() *完整程式碼見下方<br>            ],<br>          ),<br>        ),<br>      ),<br>    );<br>  }<br><br><br>//method: setGalleryItem()<br>  SizedBox setGalleryItem(int serialNum) { //設置數字型別的參數<br>    return SizedBox(<br>      width: 260,<br>      height: 260,<br>      child: Container(<br>        decoration: BoxDecoration( <br>          borderRadius: BorderRadius.all(Radius.circular(12)), //使用 BoxDecoration 設置圓角<br>        ),<br>        clipBehavior: Clip.hardEdge, //使 container 內的 child 也會被 clipped 成圓角<br>        child: Image.asset(<br>          &#39;assets/gallery/shellieMay$serialNum.jpg&#39;,<br>        ),<br>      ),<br>    );<br>  }<br>}</pre><h3>完整頁面拼接</h3><pre>import &#39;package:about_shellie_may/icon_set.dart&#39;;<br>import &#39;package:about_shellie_may/shellie_may.dart&#39;;<br>import &#39;package:flutter/material.dart&#39;;<br><br>class MainApp extends StatelessWidget {<br>  const MainApp({super.key});<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return MaterialApp(<br>      debugShowCheckedModeBanner: false,<br>      home: Scaffold(<br>        appBar: AppBar(<br>          title: BarTitle(),<br>        ),<br>        body: Stack(<br>          children: [<br>            Background(),<br>            Padding(<br>              padding: EdgeInsets.symmetric(<br>                horizontal: 24,<br>              ),<br>              child: SingleChildScrollView(<br>                scrollDirection: Axis.vertical,<br>                child: Column(<br>                  children: [<br>                    Wrap(<br>                      runSpacing: 16,<br>                      children: [<br>                        Avatar(),<br>                        Description(),<br>                        DetailsTable(),<br>                        Gallery(),<br>                      ],<br>                    )<br>                  ],<br>                ),<br>              ),<br>            )<br>          ],<br>        ),<br>      ),<br>    );<br>  }<br>}<br><br>void main() {<br>  runApp(const MainApp());<br>}</pre><h3>兩週作業比較</h3><p>兩次作業的 method/ widget tree放一起看，清爽多啦～</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dYUxW_-RLEB_eB3qZS63AA.png" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=604c0478d807" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-05-%E8%A3%BD%E4%BD%9C-about-%E9%A0%81%E9%9D%A2-2-604c0478d807">Flutter作業#05 — 製作 about 頁面(2)</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Flutter作業#02 — 製作 about 頁面]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-02-%E8%A3%BD%E4%BD%9C-about-%E9%A0%81%E9%9D%A2-de3c2c8d90e8?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/de3c2c8d90e8</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Fri, 26 Jul 2024 16:03:14 GMT</pubDate>
            <atom:updated>2024-07-27T04:31:48.640Z</atom:updated>
            <content:encoded><![CDATA[<h3>Flutter作業#04 — 製作 about 頁面</h3><p>作業：打造吸睛的 About 頁面</p><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84%E8%A9%A6%E7%85%89-%E5%8B%87%E8%80%85%E7%9A%84-100-%E9%81%93-swift-ios-app-%E8%AC%8E%E9%A1%8C/211-%E6%89%93%E9%80%A0%E5%90%B8%E7%9D%9B%E7%9A%84-about-%E9%A0%81%E9%9D%A2-7caca09d5131">#211 打造吸睛的 About 頁面</a></p><pre><a href="#43ea">成品 gif</a><br><a href="#70c1">匯入圖片</a><br><a href="#ed28">各 widget/ method 拆分</a><br><a href="#cff6">完整頁面拼接</a></pre><h3>成品 gif</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/324/1*8e2byhtZSuYufZPpAj5I4w.gif" /></figure><h3>匯入圖片</h3><ol><li>創建 assets 資料夾</li><li>將圖片導入（直接複製貼入資料夾即可）</li><li>在 pubspec.yaml 頁面的 flutter 下一階層（要空 2 個空格！）放入 assets 與圖片路徑（ “-” 前也要 2 個空格、“-”後要 1 個空格）。</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*h0umFtS4OUPiKWDJLGiycQ.png" /></figure><h3>各 widget/ method 拆分</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pUjVz-E2UHc1HZ7RbowbTg.png" /></figure><h4>buildAppBar()</h4><pre>  AppBar buildAppBar() { <br>    return AppBar(<br>      title: Text(<br>        &quot;達菲 Duffy&quot;,<br>        style: TextStyle(<br>          fontWeight: FontWeight.bold,<br>        ),<br>      ),<br>    );<br>  }</pre><p>＊AppBar 如果使用 extract widget 會出現錯誤提示: ‘The argument type ‘buildBarTitle’ can’t be assigned to the parameter type ‘PreferredSizeWidget?’，不過改用 extract method 就沒問題了。</p><h4>buildBackground()</h4><pre>class buildBackground extends StatelessWidget {<br>  const buildBackground({<br>    super.key,<br>  });<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return Container(<br>      constraints: BoxConstraints.expand(), //使 child widget 對齊 parent widget 四邊<br>      child: Opacity(<br>        opacity: 0.24, //透明度<br>        child: Image.asset( <br>          &#39;assets/background.jpg&#39;, //呼叫圖片路徑<br>          fit: BoxFit.cover,//使圖片自動縮放以填滿整個空間<br>        ),<br>      ),<br>    );<br>  }<br>}</pre><p>＊BoxConstraints.expand() 是 Flutter 中用來建立一個 BoxConstraints 的方法，這個方法會將 BoxConstraints 的寬度和高度設置為無限，這意味著子 widget 將被擴展到父 widget 可用的所有空間。這在需要讓 widget 充滿整個可用空間時非常有用，例如在構建佈局或佈局容器時。</p><p>＊BoxFit.cover 是 Flutter 中的一個屬性，用於控制如何將圖像或其他可伸縮的內容適應其容器的大小。當使用 BoxFit.cover 時，內容會被縮放並裁剪，以確保無論容器的比例如何變化，都能填滿整個容器，並且不會出現未填滿的空白區域。</p><h4>buildAvatar()</h4><pre>  Padding buildAvatar(String fileName) {<br>    return Padding(<br>      padding: const EdgeInsets.all(8.0), //使 child widget 上下左右四方都能有相同的空間距離<br>      child: SizedBox( //使用 SizedBox 設置 child widget 的尺寸<br>        width: 320, <br>        height: 320,<br>        child: CircleAvatar( //此 widget 自動生成圓形遮罩的圖片<br>          foregroundImage: AssetImage(&#39;assets/avatar/$fileName.jpg&#39;),<br>        ),<br>      ),<br>    );<br>  }<br>}</pre><h4>buildDescription()</h4><pre>  Padding buildDescription(String descrip) {<br>    return Padding(<br>      padding: const EdgeInsets.symmetric(vertical: 24),//設置上下方皆有 24 的間距<br>      child: Text(<br>        descrip, //設置成參數以便後續重複使用<br>        style: TextStyle(fontSize: 18),<br>      ),<br>    );<br>  }</pre><h4>buildDetailRow()</h4><pre>  Row buildDetailRow(<br>      IconData iconName, Color colorName, String subtitle, String gender) {<br>    return Row(<br>      children: [<br>        Expanded(<br>          flex: 1, //在 Row 中將每個 children widgets 用 Expanded 包住並設置flex ，來決定不同 widgets 所佔的空間比例。<br>          child: Container(<br>            child: Padding(<br>              padding: const EdgeInsets.all(4),<br>              child: Column(<br>                crossAxisAlignment: CrossAxisAlignment.start, //Column 的 corssAxis 是水平向，對齊最左側。<br>                children: [<br>                  Icon(<br>                    iconName, //設置成型別為 IconData 的參數<br>                    size: 36,<br>                    color: colorName, //設置成型別為 String 的參數<br>                  ),<br>                  Text(<br>                    subtitle, //設置成型別為 String 的參數<br>                    style: TextStyle(fontSize: 14),<br>                  )<br>                ],<br>              ),<br>            ),<br>          ),<br>        ),<br>        Expanded(<br>          flex: 5, //這個 flex 比較高，在此 row 中所佔空間就比較大<br>          child: Container(<br>            child: Text(<br>              gender, //設置成型別為 String 的參數<br>              style: TextStyle(<br>                fontSize: 18,<br>              ),<br>            ),<br>          ),<br>        ),<br>      ],<br>    );<br>  }</pre><p>＊Expanded widget 是 Flutter 中的一個布局 widget，它用來在 Flex 容器（例如 Row 或 Column）中展開子 widget 以填滿可用空間。 Expanded 使用 flex 屬性來確定如何在可用空間中分配其大小。</p><p>flex 屬性是用來指定這個 Expanded widget 應該分配到多少可用空間，默認值是 1。當有多個 Expanded widget 存在時，flex 屬性的值會決定每個 Expanded widget 占用的空間比例。</p><h4>buildGallery()</h4><pre>  SingleChildScrollView buildGallery(String characterName) {<br>    //有三張圖片，本來想試試用 for loop 方式回傳三次 galleryItem 的，但水平還不夠沒能成功🤣 ，就先一步步手動設置啦。<br>    String file1 = characterName + &quot;1&quot;; <br>    String file2 = characterName + &quot;2&quot;;<br>    String file3 = characterName + &quot;3&quot;;<br><br>    return SingleChildScrollView(<br>      scrollDirection: Axis.horizontal, //這次是要橫向滑動<br>      child: SizedBox(<br>        width: 810,<br>        child: Row(<br>          mainAxisAlignment: MainAxisAlignment.spaceBetween, //最左跟最右對齊 parent widget，中間生成等距空位。<br>          children: [<br>            galleryItem(file1),<br>            galleryItem(file2),<br>            galleryItem(file3),<br>          ],<br>        ),<br>      ),<br>    );<br>  }<br><br><br><br>//galleryItem()：<br>  SizedBox galleryItem(String fileName) {<br>    return SizedBox(<br>      width: 260,<br>      height: 260,<br>      child: ClipRRect( //製作圓角圖片！ 是 swift 的 clipToBound 了😆<br>          borderRadius: BorderRadius.circular(12), //= 設置 layer.cornerRadius<br>          child: Image.asset(&#39;assets/gallery/$fileName.jpg&#39;)),<br>    );<br>  }</pre><p>＊ClipRRect 是 Flutter 中的一個 widget，用來裁剪其子 widget 的形狀，通常是以圓角矩形的形式。</p><p>＊borderRadius: 用來設定圓角的半徑。可以使用 BorderRadius.circular(radius) 來設置所有四個角的半徑相同，也可以使用 BorderRadius.only 來為不同的角設置不同的半徑。</p><h3>完整頁面拼接</h3><pre>class MainApp extends StatelessWidget {<br>  MainApp({super.key});<br><br>  @override<br>  Widget build(BuildContext context) {<br>    return MaterialApp(<br>      debugShowCheckedModeBanner: false, //隱藏模擬器右上方的 &quot;debug&quot; 小紅標<br>      home: Scaffold(<br>        appBar: buildAppBar(),<br>        body: Stack(children: [ //使用 Stack 使得背景圖片與前面的文字內容可以z軸疊加<br>          buildBackground(),<br>          Padding(<br>            padding: EdgeInsets.symmetric(horizontal: 24),//設置左右方皆有 24 的間距<br>            child: SingleChildScrollView( //scrollView 使得超出螢幕高度的內容可以滑動顯示<br>              child: Column( //使用 column 來安裝直向的 widgets<br>                children: [<br>                  buildAvatar(&quot;duffy&quot;),<br>                  buildDescription(<br>                      &quot;&quot;&quot;米妮為了讓米奇在環遊世界不會感到孤單，於是在米奇準備出海遠航前親手為米奇風之了一直泰迪熊玩偶，這便是達菲熊故事的開始。由於米奇實在喜歡這隻玩偶，甚至希望能和他一起散步，所以後來奇妙仙子邊賦予了達菲熊生命。達菲變作為了了在達菲熊家族第一個誕生的人物。他臉上有著與米奇相似的形狀，有著棕色的毛髮。&quot;&quot;&quot;),<br>                  Divider(height: 1), //分隔線<br>                  buildDetailRow(<br>                      Icons.account_circle, Colors.red.shade400, &quot;性別&quot;, &quot;男&quot;),<br>                  Divider(height: 1), //分隔線<br>                  buildDetailRow(<br>                      Icons.stars, Colors.orange, &quot;特徵&quot;, &quot;腳掌和屁股上有著米奇形狀的印記&quot;),<br>                  Divider(height: 1), //分隔線<br>                  buildDetailRow(Icons.mood, Colors.green.shade600, &quot;性格&quot;, &quot;害羞&quot;),<br>                  Divider(height: 1), //分隔線<br>                  buildDetailRow(Icons.recommend, Colors.blue.shade800, &quot;愛好&quot;,<br>                      &quot;旅遊，拍照，認識新朋友&quot;),<br>                  Divider(height: 1), //分隔線<br>                  SizedBox(height: 24), //手動設置空位<br>                  buildGallery(&quot;duffy&quot;),<br>                  SizedBox(height: 36), //手動設置空位<br>                ],<br>              ),<br>            ),<br>          ),<br>        ]),<br>      ),<br>    );<br>  }<br><br><br>void main() {<br>  runApp(MainApp());<br>}</pre><p>＊其實有幾次 widget 的小燈泡沒有提供直接 extract method 的選項，就乾脆自行手動創建 Row xxxxx()，再把這一整段程式碼剪下後直接貼上😆 確認最後 return 是正確的 widget 型別就好～</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=de3c2c8d90e8" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-02-%E8%A3%BD%E4%BD%9C-about-%E9%A0%81%E9%9D%A2-de3c2c8d90e8">Flutter作業#02 — 製作 about 頁面</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Flutter作業#03 — 定義 function，印出歌詞]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-03-%E5%AE%9A%E7%BE%A9-function-%E5%8D%B0%E5%87%BA%E6%AD%8C%E8%A9%9E-ba1bc0535d27?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/ba1bc0535d27</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Thu, 25 Jul 2024 04:29:02 GMT</pubDate>
            <atom:updated>2024-07-25T07:29:34.751Z</atom:updated>
            <content:encoded><![CDATA[<h3>Flutter作業#03 — 定義 function，印出歌詞</h3><p>作業：</p><p>#64 定義 function，印出讓自己一秒落淚的情歌歌詞</p><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84%E8%A9%A6%E7%85%89-%E5%8B%87%E8%80%85%E7%9A%84-100-%E9%81%93-swift-ios-app-%E8%AC%8E%E9%A1%8C/%E5%AE%9A%E7%BE%A9-function-%E5%8D%B0%E5%87%BA%E8%AE%93%E8%87%AA%E5%B7%B1%E4%B8%80%E7%A7%92%E8%90%BD%E6%B7%9A%E7%9A%84%E6%83%85%E6%AD%8C%E6%AD%8C%E8%A9%9E-851ff4147fda">#64 定義 function，印出讓自己一秒落淚的情歌歌詞</a></p><p>這次來用 Lindsey Sterling 的 &lt;Something Wild&gt; 歌詞來練習。首先拆分歌詞各段落：</p><blockquote>You had your maps drawn<br>You had other plans<br>To hang your hopes on<br>Every road they led you down felt so wrong<br>So you found another way</blockquote><blockquote>You’ve got a big heart<br>The way you see the world<br>It got you this far<br>You might have some bruises<br>And a few of scars<br>But you know you’re gonna be okay</blockquote><p>這一段 verse 沒有重複段落，可直接印出：</p><pre>void verse1() { //因為只需要 print 出文字不需要 return，故使用 void 開頭<br>  print(<br>    &quot;&quot;&quot;You had your maps drawn<br>You had other plans<br>To hang your hopes on<br>Every road they led you down felt so wrong<br>So you found another way<br>You&#39;ve got a big heart<br>The way you see the world<br>It got you this far<br>You might have some bruises<br>And a few of scars<br>But you know you&#39;re gonna be okay&quot;&quot;&quot;,<br>  );<br>}</pre><blockquote>Even though you’re scared<br>You’re stronger than you know</blockquote><blockquote>If you’re lost out where the lights are blinding<br>Caught in all, the stars are hiding<br>That’s when something wild calls you home, home</blockquote><blockquote>If you face the fear that keeps you frozen<br>Chase the sky into the ocean<br>That’s when something wild calls you home, home</blockquote><p>這一段副歌比較複雜一點，每一小段會各自單獨重複、有時候還會有點不同的改動：</p><pre>void stronger(bool evenThough) { //用 bool 來決定改動的歌詞部分<br>  String chore1 = &quot;Even though&quot;;<br>  String chore2 = &quot;Even if&quot;;<br>  String trailing = &quot;&quot;&quot;you&#39;re scared<br>You&#39;re stronger than you know&quot;&quot;&quot;;<br><br>  if (evenThough == true) { //記得要 &quot;==&quot;。這裡少輸入一個 &quot;=&quot; 不會自動提醒！！然後就只會一直觸發 evenThough == true 的情況😂<br>    print(&quot;$chore1 $trailing&quot;); //這裡試著用 $ 呼叫<br>  } else {<br>    print(chore2 + &quot; &quot; + trailing); //這邊則嘗試用 + 連接<br>  }<br>}<br><br><br>void callsYouHome() { //這一段會在下面兩個 void 中重複，故特別 extract 出來。<br>  print(<br>    &quot;That&#39;s when something wild calls you home, home&quot;,<br>  );<br>}<br><br><br>void lost() {<br>  print(<br>      &quot;If you&#39;re lost out where the lights are blinding\nCaught in all, the stars are hiding&quot;);<br>  callsYouHome(); //呼叫剛剛 extract 的 func<br>}<br><br><br>void fear() {<br>  print(<br>      &quot;If you face the fear that keeps you frozen\nChase the sky into the ocean&quot;);<br>  callsYouHome(); //呼叫剛剛 extract 的 func<br>}</pre><blockquote>Sometimes the past can<br>Make the ground beneath you feel like quicksand<br>You don’t have to worry<br>Reach for my hand<br>And I know you’re gonna be okay<br>You’re gonna be okay</blockquote><p>這一段是單純的 verse 直接印出：</p><pre>void verse2() {<br>  print(<br>    &quot;&quot;&quot;Sometimes the past can<br>Make the ground beneath you feel like quicksand<br>You don&#39;t have to worry<br>Reach for my hand<br>And I know you&#39;re gonna be okay<br>You&#39;re gonna be okay&quot;&quot;&quot;,<br>  );<br>}</pre><blockquote>Calls you home<br>Calls you home<br>Calls you home<br>Calls you home</blockquote><p>這一段落剛好重複了四句一樣的歌詞，故練習使用 for loop：</p><pre>void hoemLoop() {<br>  String line = &quot;Calls you home&quot;;<br><br>  for (var i = 0; i &lt; 4; i++) { //輸入 for 就有自動完成的選項出現，選擇後就自動出現這列程式碼啦！只要改動要重複的次數即可。<br>    print(line);<br>  }<br>}</pre><p>最後在 main() 裡呼叫所有的 func 就完成啦！</p><pre>void main(List&lt;String&gt; arguments) {<br>  verse1();<br>  stronger(true);<br>  lost();<br>  fear();<br>  verse2();<br>  stronger(false);<br>  lost();<br>  fear();<br>  hoemLoop();<br>  lost();<br>  lost();<br>  fear();<br>}</pre><p>成果：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/938/1*GgTN8kGLc1tWR1cDl0qMXw.jpeg" /></figure><p>歡迎搭配歌曲服用～</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FytMqO-WQpQ4%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DytMqO-WQpQ4&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FytMqO-WQpQ4%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/c293d241f74d015ccb544f56f94bca66/href">https://medium.com/media/c293d241f74d015ccb544f56f94bca66/href</a></iframe><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ba1bc0535d27" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-03-%E5%AE%9A%E7%BE%A9-function-%E5%8D%B0%E5%87%BA%E6%AD%8C%E8%A9%9E-ba1bc0535d27">Flutter作業#03 — 定義 function，印出歌詞</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Flutter作業#02 — 製作 App 畫面顯示文字]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-02-%E8%A3%BD%E4%BD%9C-app-%E7%95%AB%E9%9D%A2%E9%A1%AF%E7%A4%BA%E6%96%87%E5%AD%97-d870c539d04c?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/d870c539d04c</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Mon, 22 Jul 2024 09:59:35 GMT</pubDate>
            <atom:updated>2024-07-22T10:06:52.444Z</atom:updated>
            <content:encoded><![CDATA[<h3>Flutter作業#02 — 製作 App 畫面顯示文字</h3><p><strong>作業要求：</strong></p><ul><li>定義 StatelessWidget 製作 App 畫面顯示文字(使用到 MaterialApp、Scaffold、Center、Text、TextStyle)</li><li><a href="https://api.flutter.dev/flutter/widgets/RichText-class.html">補充: RichText widget</a></li></ul><pre><br><a href="#93a9">一、基礎版 (Text 設置)</a><br>  <a href="#75e6">＊小筆記：trailing comma</a><br>  <br><a href="#eebe">二、進階版(使用 column 添加多組 Text)</a><br>  <a href="#1ef6">＊小筆記：小燈泡選項</a><br>  <a href="#0106">＊小筆記：fontWeight</a><br><br><a href="#1eb0">三、挑戰版（RichText &amp; TextSpan）</a><br><br><a href="#2f1d">⁍Text 與 RichText 的常用參數整理</a><br></pre><p>Flutter 課程的第一項 Dart 語法作業是練習在畫面上顯示文字。不過目前還沒有介紹到 StatelessWidget 類別，我就先把程式碼都直接放到 runApp() 裡啦😆</p><p>剛好最近看到一組很可愛的文字廣告，正好可以拿來當練習題目～</p><h3>一、基礎版</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*hrKOTPoFAKI8pHORzOcfGg.jpeg" /></figure><h4>文字要求：</h4><p>- 字體顏色綠色<br>- 大字體<br>- 文字對齊方式左右對齊</p><h4>程式碼：</h4><pre>void main() {<br>  runApp(MaterialApp(<br>    home: Scaffold(<br>      body: Center(<br>        child: Text(<br>          &quot;If everyone came \nto us, this poster \nwouldn&#39;t need to \nbe so big&quot;, //換行符號一樣是\n<br>          style: TextStyle(<br>            fontSize: 120, //大字體<br>            color: Color.fromARGB(255, 0, 126, 41), //綠色<br>            height: 1, //原本預設的行高間距太寬啦，故手動調整行高。<br>          ),<br>          textAlign: TextAlign.justify, //左右兩邊都要對齊<br>        ),<br>      ),<br>    ),<br>  ));<br>}</pre><p><strong>chrome 網頁畫面呈現：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*B9fsIRPJtFm3_vxICI05jQ.png" /></figure><h4>＊小筆記：</h4><ol><li><strong>trailing comma</strong></li></ol><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84-flutter-app-%E9%96%8B%E7%99%BC%E5%95%8F%E9%A1%8C%E8%A7%A3%E7%AD%94%E9%9B%86/%E5%B9%AB%E5%8A%A9-flutter-%E7%B8%AE%E6%8E%92%E7%A8%8B%E5%BC%8F%E7%9A%84-trailing-commas-cee29be93684">幫助 Flutter 縮排程式的 trailing-commas</a></p><p>要在括弧前額外再加個 “，”：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NseM4GveBA51dtcIETPVNw.png" /></figure><p>自動換行啦！</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OXZAGwG5istOVokcBKd_dQ.png" /></figure><h3>二、進階版</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*PyX-CSaZdWjPq--taCVx2Q.jpeg" /></figure><h4>文字要求：</h4><p>- 兩種字體尺寸<br>- 字體顏色綠色<br>- 字體加粗<br>- 文字對齊方式置中</p><h4>程式碼：</h4><pre>void main() {<br>  runApp(MaterialApp(<br>    home: Scaffold(<br>      body: Center(<br>        child: Column( //要設定兩種不同的 text widgets，故加入 Column layout<br>          mainAxisAlignment: MainAxisAlignment.center, //輸入 align 就會自動出現選項～<br>          children: [ //Column 是 Multi-child layout，所以內部的 widgets 要用 children[] 包起來<br>            Text( //第一段文字<br>              &quot;Can the people who can read this poster \ntell the people who can&#39;t to book an eye test&quot;,<br>              style: TextStyle(<br>                fontSize: 36, //字體較大<br>                color: Color.fromARGB(255, 0, 126, 41),<br>                fontWeight: FontWeight.bold, //字體加粗<br>                height: 1,<br>              ),<br>              textAlign: TextAlign.center,<br>            ),<br>            Text( //第二段文字<br>              &quot;\n(Thanks)&quot;,<br>              style: TextStyle(<br>                  fontSize: 22, //字體較小<br>                  color: Color.fromARGB(255, 0, 126, 41),<br>                  height: 1,<br>                  fontWeight: FontWeight.w600), //字體中粗<br>            ),<br>          ],<br>        ),<br>      ),<br>    ),<br>  ));<br>}</pre><p><strong>chrome 網頁畫面呈現：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*81K-3R3M_kbro9B0KOrLQw.png" /></figure><h4>＊小筆記：</h4><ol><li><strong>小燈泡選項</strong></li></ol><p>在 Center 這一層會出現 “Remove this widget” 選項，但在 Column 卻找不到：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/874/1*0SFIRO8xNI9wSVrq5-s8Wg.png" /></figure><p>詢問 ChatGPT 後得到的答案是因為要看 widget 屬於 Single-child layout 或Multi-child layout ：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Y9EKve3H-QHPVUc56avabg.png" /></figure><p>另外像是 Text 這種 basic widget，則有另一組選項 Move widget down/ up 可以選擇：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QeXfgJJ8K3nNJPLDFqZwMQ.png" /></figure><p>ChatGPT 的回答：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5qQiUyvENGzHIVXi2Y7wzg.png" /></figure><p><strong>2. fontWeight</strong></p><p>在設置 fontWeight 時，發現 flutter 自動完成的選項中除了 normal 與 bold 之外，還有出現 w100-w900，一一測試之後發現好像沒什麼差別…? 詢問 ChatGPT 後告知可能是字體或渲染引擎沒有支援😂</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/336/1*VcA5u5Xj6TkKz7ug8ioe2Q.png" /><figcaption>測試結果</figcaption></figure><h3>三、挑戰版</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1006/1*BZNl5CrNYsqNynnVxbLsRA.jpeg" /></figure><h4>文字要求：</h4><p>- 同一段話中設置不同文字顏色（richText）</p><h4>程式碼：</h4><pre>//先設置兩種 TextStyle 的變數：<br>var greyStyle = TextStyle( //這邊用習慣的 var 設置<br>  fontSize: 64,<br>  fontWeight: FontWeight.bold,<br>  color: Colors.grey,<br>);<br><br>TextStyle blackStyle = TextStyle( //這邊用新學的 dart 語法：直接用型別宣告。比較特別的是 TextStyle 的 T 要大寫，跟 String 一樣。使用 textStyle 反而會出現錯誤提示。<br>  fontSize: 64,<br>  fontWeight: FontWeight.bold,<br>  color: Colors.black,<br>);<br><br>void main() {<br>  runApp(<br>    MaterialApp(<br>      home: Scaffold(<br>        body: Center(<br>          child: RichText( //因為同一段文字要套用不同的 style，故使用 RichText widget<br>            textAlign: TextAlign.center,<br>            text: TextSpan( <br>              text: &quot;WE WANTED TO WRITE ABOUT &quot;,<br>              style: greyStyle,<br>              children: &lt;TextSpan&gt;[ //後續的 TextSpan list 是包在第一個 TextSpan 下的第一層<br>                TextSpan(text: &quot;OUR &quot;, style: blackStyle),<br>                TextSpan(text: &quot;LOCALLY SOURCED NATURAL &quot;, style: greyStyle),<br>                TextSpan(text: &quot;INGREDIENTS&quot;, style: blackStyle),<br>                TextSpan(<br>                    text: &quot;, BUT SHORT BILLBOARD HEADLINES &quot;, style: greyStyle),<br>                TextSpan(text: &quot;ARE BETTER&quot;, style: blackStyle),<br>              ],<br>            ),<br>          ),<br>        ),<br>      ),<br>    ),<br>  );<br>}</pre><p><strong>chrome 網頁畫面呈現：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*p6ZcxF8Mcm-n9Xko8StOig.png" /></figure><h3>⁍Text 與 RichText 的常用參數整理：</h3><p>*from ChatGPT</p><h4>Text Widget</h4><p>Text 是 Flutter 中用於顯示一行或多行文本的基本 widget。它適合用於顯示簡單的文本內容。</p><p><strong>常用參數</strong></p><ul><li><strong>data</strong> (String)：要顯示的文本內容。</li><li><strong>style</strong> (TextStyle)：文本的樣式，包括字體大小、顏色、字重等。</li><li><strong>textAlign</strong> (TextAlign)：文本的對齊方式，如 TextAlign.left, TextAlign.center, TextAlign.right 等。</li><li><strong>textDirection</strong> (TextDirection)：文本的方向，如 TextDirection.ltr (從左到右) 或 TextDirection.rtl (從右到左)。</li><li><strong>overflow</strong> (TextOverflow)：文本溢出時的處理方式，如 TextOverflow.ellipsis (省略號)。</li><li><strong>maxLines</strong> (int)：顯示的最大行數。</li><li><strong>softWrap</strong> (bool)：是否根據需要自動換行。</li><li><strong>strutStyle</strong> (StrutStyle)：設置文本的行間距和對齊等屬性。</li></ul><p><strong>範例</strong></p><pre>Text(<br>  &#39;Hello, Flutter!&#39;,<br>  style: TextStyle(<br>    fontSize: 24,<br>    color: Colors.blue,<br>    fontWeight: FontWeight.bold,<br>  ),<br>  textAlign: TextAlign.center,<br>  overflow: TextOverflow.ellipsis,<br>  maxLines: 2,<br>)</pre><h4>2. RichText Widget</h4><p>RichText 是一個可以顯示複雜文本的 widget，支持不同的樣式和文本片段的混合。</p><p><strong>常用參數</strong></p><ul><li><strong>text</strong> (TextSpan)：要顯示的文本內容，這個 TextSpan 可以包含子 TextSpan 來顯示複雜文本。</li><li><strong>textAlign</strong> (TextAlign)：文本的對齊方式，適用於 RichText 內部的文本。</li></ul><p><strong>TextSpan 常用參數</strong></p><ul><li><strong>text</strong> (String)：要顯示的文本內容。</li><li><strong>style</strong> (TextStyle)：文本的樣式，包括字體大小、顏色、字重等。</li><li><strong>children</strong> (List&lt;TextSpan&gt;)：包含的子 TextSpan 列表，用於創建多樣式文本。</li></ul><p><strong>範例</strong></p><pre>RichText(<br>  text: TextSpan(<br>    text: &#39;Welcome to &#39;,<br>    style: TextStyle(color: Colors.black, fontSize: 20),<br>    children: &lt;TextSpan&gt;[<br>      TextSpan(<br>        text: &#39;Flutter!&#39;,<br>        style: TextStyle(color: Colors.blue, fontWeight: FontWeight.bold),<br>      ),<br>      TextSpan(<br>        text: &#39; This is a demo of &#39;,<br>        style: TextStyle(color: Colors.black),<br>      ),<br>      TextSpan(<br>        text: &#39;RichText&#39;,<br>        style: TextStyle(color: Colors.red, fontStyle: FontStyle.italic),<br>      ),<br>    ],<br>  ),<br>  textAlign: TextAlign.center,<br>)</pre><h4>比較</h4><ul><li><strong>Text</strong>：<br>- 適合顯示單一樣式的簡單文本。<br>- 不支持內嵌不同樣式的文本片段。</li><li><strong>RichText</strong>：<br>- 適合顯示複雜文本，支持多種樣式和格式。<br>- 使用 TextSpan 來構建多層次的文本樣式。</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d870c539d04c" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-02-%E8%A3%BD%E4%BD%9C-app-%E7%95%AB%E9%9D%A2%E9%A1%AF%E7%A4%BA%E6%96%87%E5%AD%97-d870c539d04c">Flutter作業#02 — 製作 App 畫面顯示文字</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Flutter作業#01 — Widget catalog]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-01-widget-catalog-2d556e149f92?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/2d556e149f92</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Sat, 20 Jul 2024 09:22:27 GMT</pubDate>
            <atom:updated>2024-07-20T16:07:10.329Z</atom:updated>
            <content:encoded><![CDATA[<h3>Flutter作業#01 — Widget catalog</h3><p>跟剛開始學 Swift 要先熟悉 Swift 各種元件一樣，第一份 Flutter 作業要先來熟悉 Flutter 會用到的 Widgets～ 這次也用 Xmid 來做了個 mind map 筆記：</p><p><strong>Xmind 筆記連結：</strong></p><p><a href="https://xmind.app/m/2vJfqN">Flutter Widgets</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ASB-bLR4Zxp6xjWpENZ2XA.png" /></figure><p>筆記中 widgets 截圖來自 Flutter 官網的 <a href="https://docs.flutter.dev/ui/widgets">Widget Catalog</a> 文件：</p><p><a href="https://docs.flutter.dev/ui/widgets">Widget catalog</a></p><p>以及 <a href="https://flutter.github.io/samples/web/material_3_demo/">material 3 demo</a>：</p><p><a href="https://flutter.github.io/samples/web/material_3_demo/">material_3_demo</a></p><p>程式碼範例則感謝 ChatGPT 提供🙏：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JoXFnnO4f6yYdzKH2mmmTg.png" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2d556e149f92" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/flutter%E4%BD%9C%E6%A5%AD-01-widget-catalog-2d556e149f92">Flutter作業#01 — Widget catalog</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[筆記#3 — 使用 AdMob 插入廣告並設置內購(IAP)去廣告]]></title>
            <link>https://medium.com/@peichi/%E4%BD%BF%E7%94%A8-admob-%E6%8F%92%E5%85%A5%E5%BB%A3%E5%91%8A%E4%B8%A6%E8%A8%AD%E7%BD%AE%E5%85%A7%E8%B3%BC-iap-%E5%8E%BB%E5%BB%A3%E5%91%8A-5ff5169b07c2?source=rss-6727edfba6fc------2</link>
            <guid isPermaLink="false">https://medium.com/p/5ff5169b07c2</guid>
            <dc:creator><![CDATA[Pei-chi]]></dc:creator>
            <pubDate>Tue, 09 Jul 2024 07:31:04 GMT</pubDate>
            <atom:updated>2024-07-11T08:14:25.174Z</atom:updated>
            <content:encoded><![CDATA[<p>其實這篇好幾個月前就已經把各種操作截圖跟大綱都列好了，只是拖延症發作沒把說明文字打完🙈 剛好這個暑假回來上彼得潘的 Flutter 課程，忽然發現居然還有這篇文章一直存在草稿裡！趕快補上文字與大家分享這段篳路藍縷的 Admob 及 IAP設置路程 🤣🤣🤣</p><p><strong>參考網頁：</strong></p><ul><li><a href="https://developers.google.com/admob/ios/quick-start?hl=zh-TW">開始使用 | iOS | Google for Developers</a></li><li><a href="https://www.appcoda.com.tw/intermediate-swift-tips/admob.html">iOS 17 App 程式設計進階攻略（試閱版）</a></li><li><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84-swift-ios-app-%E9%96%8B%E7%99%BC%E5%95%8F%E9%A1%8C%E8%A7%A3%E7%AD%94%E9%9B%86/%E6%B8%AC%E8%A9%A6-googleads-mobile-ios-examples-%E7%AF%84%E4%BE%8B-a7430bd7fa28">從 googleads mobile ios examples 認識 AdMod 的四種廣告</a></li></ul><pre><br><a href="#f84a">1. 申請 AdMob 帳號</a><br><a href="#0a50">2. 建立新的 App</a><br><a href="#7bff">3. Add ad unit</a><br><a href="#5c1a">4. 在 Xcode 中匯入 Google Mobile Ads SDK</a><br><a href="#c29c">5. 更新 Info.plist</a><br><a href="#d4ed">6. 更新 App Delegate</a><br><a href="#f72d">7. 在 App 中嵌入廣告</a><br>  <a href="#2523">&gt; Banner (橫幅廣告)</a><br>  <a href="#a4a0">&gt; Interstitial（插頁式廣告）</a><br><a href="#a87b">8. 設置內購去廣告</a><br><a href="#672b">9. App 上架時</a><br><a href="#cef1">10. App 上架後</a><br><a href="#022c">＊查看 AdMob 報告</a></pre><h3>1. 申請 AdMob 帳號</h3><p>→ AdMob 首頁:</p><p><a href="https://admob.google.com/">Google AdMob - Earn More With Mobile App Monetization</a></p><p><strong>i. 使用 google 帳號登入後同意使用條款：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*86ceuB1FYTWufqdCDbII0w.png" /></figure><p><strong>ii. 設置 Payment 資訊：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xO1GSUzGCnJgCmSKUOi5bg.png" /></figure><p>＊ 如果點擊 “Add payments account” 但是一直沒有動靜的話，可以去確認一下網頁左上角的網頁許可設置，如果有設置任何 block 會導致彈跳視窗跑不出來（會顯示 “payments.google.com refused to connect.”)！</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1004/1*H_50JXl2s6ry-3OXAeUrHg.png" /></figure><h3>2. 建立新的 App</h3><p>因為 App 還未在商店中上架，可以先選擇 “Unpublished”，等 App 上架後再回來連結 App 上架網址。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-gi76zmnxzPsHHRiUkog3g.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*H1XmyOjAjrPvj1B92xlMdA.png" /></figure><p>就會得到一組 App Id 啦！</p><h3>3. Add ad unit</h3><p><strong>i. 選擇要使用的廣告類型</strong>：（我自己目前只有使用到 Banner 橫幅廣告 跟 Interstitial 插頁式廣告）</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*A-fq0BTnJCh3ewbQheMDNA.png" /></figure><p><strong>ii. 輸入廣告名稱：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*n29RXvdI-j2rRbUfMHgxyg.png" /></figure><p><strong>iii. 就會得到一組 Ad unit ID 啦～</strong> 不過這組 ID 先不要用！AdMob 有提供測試用的 Ad unit ID，讓我們在建置 App 時使用。如果自己使用到自己的 Ad ID 會被偵測為 Invalid activity，最嚴重可能會關閉帳號哦。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NpMNenU-jHxpsR2nTeks4w.png" /></figure><p>＊Google 提供測試用的 Ad ID：</p><p><a href="https://developers.google.com/admob/ios/test-ads">Enabling test ads | iOS | Google for Developers</a></p><h3>4. 在 Xcode 中匯入 Google Mobile Ads SDK</h3><p><strong>i. 打開 File &gt; Add Packages Dependencies</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/914/1*sk0jskK0W5kN9aCrFkk5rQ.png" /></figure><p><strong>ii. 右上角搜尋 “</strong><strong>https://github.com/googleads/swift-package-manager-google-mobile-ads.git”，選擇 “add package”</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8vUndCClfFbDd9MrGym1rg.png" /></figure><h3>5. 更新 Info.plist</h3><p><strong>i. 複製 </strong><a href="https://developers.google.com/admob/ios/quick-start?hl=zh-TW"><strong>Google AdMob Mobile Ads SDK 說明</strong></a><strong>上的這段程式碼</strong></p><pre>&lt;key&gt;GADApplicationIdentifier&lt;/key&gt;<br>&lt;string&gt;ca-app-pub-*********&lt;/string&gt; //這裡要更換為自己的 App ID<br>&lt;key&gt;SKAdNetworkItems&lt;/key&gt;<br>&lt;array&gt;<br>  &lt;dict&gt;<br>    &lt;key&gt;SKAdNetworkIdentifier&lt;/key&gt;<br>    &lt;string&gt;cstr6suwn9.skadnetwork&lt;/string&gt;<br>  &lt;/dict&gt;<br> ...... //完整程式碼太長啦！！請直接見網頁~<br>  &lt;dict&gt;<br>    &lt;key&gt;SKAdNetworkIdentifier&lt;/key&gt;<br>    &lt;string&gt;3qcr597p9d.skadnetwork&lt;/string&gt;<br>  &lt;/dict&gt;<br>&lt;/array&gt;</pre><p><strong>ii. 在 xCode 中右擊 Info &gt; 選擇 Open As &gt; Souce Code</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/986/1*4tyfEdE-jQVEFrv_QiiJMg.png" /></figure><p><strong>iii. 把剛剛複製的程式碼貼進 Info.plist 中</strong>:<br>（貼入&lt;/dict&gt; 前即可）</p><pre>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;<br>&lt;!DOCTYPE plist PUBLIC &quot;-//Apple//DTD PLIST 1.0//EN&quot; &quot;http://www.apple.com/DTDs/PropertyList-1.0.dtd&quot;&gt;<br>&lt;plist version=&quot;1.0&quot;&gt;<br>&lt;dict&gt;<br>......<br><br>//插入開始<br>&lt;key&gt;GADApplicationIdentifier&lt;/key&gt;<br>&lt;string&gt;ca-app-pub-*********&lt;/string&gt; //自己的 App ID<br>&lt;key&gt;SKAdNetworkItems&lt;/key&gt;<br>&lt;array&gt;<br>  &lt;dict&gt;<br>    &lt;key&gt;SKAdNetworkIdentifier&lt;/key&gt;<br>    &lt;string&gt;cstr6suwn9.skadnetwork&lt;/string&gt;<br>  &lt;/dict&gt;<br> ...... <br>  &lt;dict&gt;<br>    &lt;key&gt;SKAdNetworkIdentifier&lt;/key&gt;<br>    &lt;string&gt;3qcr597p9d.skadnetwork&lt;/string&gt;<br>  &lt;/dict&gt;<br>&lt;/array&gt;<br>//插入結束<br><br>&lt;/dict&gt;<br>&lt;/plist&gt;</pre><h3>6. 更新 App Delegate</h3><p>在 App Delegate 中的 “didFinishLaunchingWithOptions” 內插入 GADMobileAds 的程式碼：</p><pre>import UIKit<br>import GoogleMobileAds //插入這行<br><br>@main<br>class AppDelegate: UIResponder, UIApplicationDelegate {<br><br>  func application(_ application: UIApplication,<br>      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -&gt; Bool {<br><br>    GADMobileAds.sharedInstance().start(completionHandler: nil) //插入這行<br><br>    return true<br>  }<br><br>}<br></pre><h3>7. 在 App 中嵌入廣告</h3><p>我自己喜歡另開一個 File ，將 AdModb 的讀取與顯示寫成獨立的 struct 類別，這樣在不同的 view controller 都可以直接呼叫，後續想要修改也比較方便：</p><pre>import GoogleMobileAds<br><br>struct Admob {<br>    //因為後續會設置內購去廣告，所以設置了一個 key value 存在 UserDefaults 來確認是否要在裝置上顯示廣告。如果 App 沒有要設置內購功能，可以直接忽略所有跟 adRemoved 相關的程式碼～<br>    static let adRemoved = UserDefaults.standard.bool(forKey: &quot;adRemoved&quot;)<br><br>    static func addBannerView() {<br>        //如果已購買去廣告（adRemoved == true）則不會運行下面的程式碼<br>        guard adRemoved else {<br>          //詳細程式碼在下方～<br>          }<br>        }<br><br>    static func addInterstitialAd() {<br>        guard adRemoved else {<br>          //詳細程式碼在下方～<br>          }<br>        }<br><br>}</pre><h4>&gt; Banner (橫幅廣告)</h4><p><a href="https://developers.google.com/admob/ios/banner">Banner Ads | iOS | Google for Developers</a></p><p><strong>i. 設置 struct Admob 內的程式碼：</strong></p><pre>static func addBannerView(_ bannerView: GADBannerView, view: UIView, self: UIViewController) {<br><br>    guard adRemoved else {<br>        bannerView.adUnitID = &quot;ca-app-pub-3940256099942544/2934735716&quot; //Demo ad unit ID<br>        <br>        bannerView.rootViewController = self<br>        bannerView.load(GADRequest())<br>        view.addSubview(bannerView)<br>        <br>        bannerView.translatesAutoresizingMaskIntoConstraints = false<br>        NSLayoutConstraint.activate([<br>            bannerView.bottomAnchor.constraint(equalTo: view.bottomAnchor), //我這裡將 banner 設置在螢幕最底端<br>            bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor),<br>            bannerView.widthAnchor.constraint(equalTo: view.widthAnchor),<br>            bannerView.heightAnchor.constraint(equalToConstant: 50) // default ad banner 尺寸： 320*50。這邊特別設置成 constraint 避免 autoLayout 時被壓縮，導致 banner 不可見。<br>        ])<br>        return<br>    }<br>}</pre><p><strong>ii. 在要使用 Banner 廣告的頁面：</strong></p><pre>var bannerView = GADBannerView(adSize: GADAdSizeBanner) // 預設的 ad banner 尺寸： 320*50<br><br>override func viewDidLoad() {<br>  //如果使用 navigation controller：<br>  Admob.addBannerViewToView(bannerView, view: self.navigationController!.view, self: self) //在首頁將 banner 設置在 navigationController.view 就好，比較方便<br><br>  //如果沒用 navigation controller：<br>  Admob.addBannerViewToView(bannerView, view: view, self: self) //在每一個要顯示廣告的 controller 都要放。<br>}<br></pre><p>＊GADAdSizeBanner：</p><p><a href="https://developers.google.com/admob/ios/api/reference/Constants">GoogleMobileAds Framework Reference | iOS | Google for Developers</a></p><p>＊這時候使用 demo Ad unit ID 不管是在 simulator 或是實體裝置上廣告都可以正常顯示啦！但如果是自己的 unit ID，則只有在 simulator 上可以看到廣告（也會顯示為 Test Mode），但在實體裝置/TestFlight上則無法。查了 Google Admob Help 是上架後才會顯示：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*nYrkpzryI0fKNnW9wr2HZw.png" /></figure><p>果然 App 通過 App review 跟 AdMob review 後廣告就出現啦～</p><h4>&gt; Interstitial（插頁式廣告）</h4><p><a href="https://developers.google.com/admob/ios/interstitial">Interstitial ads | iOS | Google for Developers</a></p><p><strong>i. 設置 struct Admob 內的程式碼：</strong></p><pre>//interstitial Ad 我把程式拆分成兩段，分別為讀取(load)及顯示(show)：<br><br>//讀取廣告並使用 escaping closure 導出讀取到的廣告（型別為 GADInterstitialAd）<br>static func loadInterStitialAd(completion: @escaping(GADInterstitialAd) -&gt; Void) {<br>                <br>    guard adRemoved else {<br>        <br>        var interStitialAd = GADInterstitialAd()<br><br>        //讀取廣告時會使用到的參數：<br>        let adUnitID = &quot;ca-app-pub-3940256099942544/4411468910&quot; // demo adUnit ID<br>        let request = GADRequest()<br><br>        //送出 load 請求後，會收到回傳 ad 或 error<br>        GADInterstitialAd.load(withAdUnitID: adUnitID, request: request) { ad, error in<br>            //如果失敗收到 error<br>            if let error {<br>                print(&quot;Failed to load interstitial ad with error: \(error.localizedDescription)&quot;)<br>                return<br>            }<br>            //如果成功收到 ad<br>            if let ad {<br>                interStitialAd = ad<br>                completion(interStitialAd) //導出收到的 ad<br>            }<br>        }<br>        return<br>    }<br>    <br>}<br>    <br>//將 Interstitial 廣告顯示在畫面上<br>static func showInterStitialAd(_ interStitialAd: GADInterstitialAd?, self: GADFullScreenContentDelegate) {<br>    <br>    guard adRemoved else {<br>        //先檢查是否成功讀取到 interStitialAd<br>        if let interStitialAd {<br>            interStitialAd.fullScreenContentDelegate = self //這裡將廣告的 fullScreenContentDelegate 設置成要顯示廣告的頁面。<br>        }else {<br>            print(&quot;Ad wasn&#39;t ready&quot;)<br>        }<br>        interStitialAd?.present(fromRootViewController: self as? UIViewController)<br>        return<br>    }<br>}</pre><p><strong>ii. 在要使用 Interstitial 廣告的頁面：</strong></p><pre>//要加入 GADFullScreenContentDelegate protocol!<br>class controller: ...,GADFullScreenContentDelegate{<br><br>    var interStitialAd: GADInterstitialAd?<br><br><br>//一般顯示 interstitial ad:<br>    func showAd() {<br>       if adRemoved {<br>            nextAction()<br>        } else {<br>            //interStitialAd 是一次性的，所以每次要用的時候都要重新讀取<br>            Admob.loadInterStitialAd { loadedAd in<br>              self.interStitialAd = loadedAd<br>              Admob.showInterStitialAd(self.interStitialAd, self: self)<br>            }<br>            nextAction() //這裡主要是避免廣告讀取失敗：如果沒能跳轉至全頁廣告，App 仍可以繼續運行自定義的 nextAction()～<br>        }<br>    }<br><br><br>    //要先設置 &quot;interStitialAd.fullScreenContentDelegate = self&quot;，這個 dismissFullScreenConten 程式才有辦法被呼叫。（我設置在 Admob struct 中）<br>    func adWillDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {<br>        //廣告即將消失時，準備下一步～<br>        nextAction()<br>    }</pre><p>p.s. 如果是想在點擊 “Back” button 返回上一頁時插入廣告，可以使用 willMove(toParent:)：</p><pre>var interStitialAd: GADInterstitialAd?<br><br>//因為點擊了 back button 就會回到上一層 controller，所以要提前讀取廣告，避免廣告還沒讀取完，畫面就已經跳轉走啦！（這個頁面只會插入一次廣告，所以可以這麼設置。如果會需要多次設置的話要記得把這個 loadedAd 存在不同變數哦！）<br><br>override func viewDidLoad() {<br>        super.viewDidLoad()<br>        Admob.loadInterStitialAd { loadedAd in<br>              self.interStitialAd = loadedAd<br>        }<br>    }<br><br>//使用 willMove(toParent) ，趁跳轉回上一個頁面前顯示讀取好的廣告：<br>override func willMove(toParent parent: UIViewController?) {<br>    super.willMove(toParent: parent)<br>    if parent == nil {<br>        Admob.showInterStitialAd(interStitialAd, self: self)<br>    }<br>}</pre><h3>8. 設置內購去廣告</h3><p>(沒有要設置去廣告功能的可以直接跳到 10. App 上架後～)</p><p>參考資料：</p><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84-swift-ios-app-%E9%96%8B%E7%99%BC%E5%95%8F%E9%A1%8C%E8%A7%A3%E7%AD%94%E9%9B%86/%E5%BE%9E%E9%9B%B6%E9%96%8B%E5%A7%8B%E9%96%8B%E7%99%BC-ios-app-%E7%9A%84-in-app-purchase-iap-45250cf2174">從零開始開發 iOS App 的 in app purchase (IAP)</a></p><p><strong>i. 先切到 Signing &amp; Capabilities，點選 “+ Capability”：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5ri2Eg6PgTCD-Y9f9pqE-Q.png" /></figure><p>點選之後 “In-App Purchase” 就會出現在下面啦！</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4_yEJZFTZJwRM2GWt0HBKw.png" /></figure><p><strong>ii. 再到 App Store Connect &gt; Apps，點選右上角 “+” 號</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WI_OaBjPjXP7mKyL0JecfQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AfGAvcjKz4ay9d2qXEoPOA.png" /></figure><p><strong>iii. 新增 App，點選 Bundle ID 就會自動冒出選項：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*G_GSQdoHbB20CldpT938MQ.png" /></figure><p><strong>iv. 到 Monetization &gt; In-App Purchase</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FK69cK6XnGzr3dxsOLPTKw.png" /></figure><p><strong>v. 開始創建 IAP~</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cb5U0ikw_-bEzqHG0EGcuA.png" /></figure><p>依照自己的設置選擇此次購買是否是消耗性的 or 永久性的：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FA_JH9lSSBUksHKCUEXs9w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*nd_BE6nc7xZpGMIqTZztuA.png" /></figure><p><strong>vi. 創建好啦：</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LYLNHsuzOmjPB1-zDOF2_A.png" /></figure><p><strong>v. 編輯 Availability 及 Price Schedule:</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Kj1FaKkuLC3g18U5i7ZjXQ.png" /></figure><p><strong>vii. 在 Localizatoion 設置使用者會看到的名稱</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5mZLCLzCMDQaXmYTjR5l6Q.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9cqVNCKxaIoy0_Xms6SvrQ.png" /></figure><p><strong>viii. 在 Xcode 中設置程式碼並創建 Test Account：</strong></p><p>Jason 大神這篇太強大啦，基本上直接套用就可以成功了(膜拜🤲)</p><p><a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84-swift-ios-app-%E9%96%8B%E7%99%BC%E6%95%99%E5%AE%A4/%E5%AF%A6%E4%BD%9Ciap%E5%85%A7%E8%B3%BC%E5%8A%9F%E8%83%BD-52293baea6f7">#39 實作IAP內購功能</a></p><p>＊我自己只有做了一點小改動：在點擊 restore 之後，出現 activity indicator 動畫，如果確認有購買紀錄則會刷新成無廣告版本、若是沒有購買及路則恢復原本的按鈕樣式。</p><p>以上設置完之後，在測試 App 中點擊購買選項會跳出視窗要求輸入帳號密碼，輸入沙盒帳密進行測試。（輸入之後手機 Setting &gt; app store 中也會出現 SANDBOX 帳號資訊～）</p><p>＊之前 priceLocale 一直失敗（顯示 “EXC_BREAKPOINT (code=1, subcode=0x188143df0)”)，等使用 Sandbox 帳號登入後、再次嘗試 priceLocale 就成功了🙌</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Untg_9C3dddvujVrfzMYLw.png" /></figure><h3>9. App 上架時</h3><p>跟一般 App 差不多，不過使用 IAP 會 collect data ，所以要好好設定 App Privacy：</p><p><a href="https://levelup.gitconnected.com/filling-out-the-app-privacy-section-in-app-store-connect-for-admob-users-bca0768ad86e">Filling out the App Privacy Section in App Store Connect for AdMob Users</a></p><h3>10. App 上架後</h3><p>App Store 成功上架後，到 AdMob 頁面上打開該 App，在左側導航欄 App Settings &gt; App store details 貼上該 App 的 App store 的網址，</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cTjbjRkLVj5AkkMP4fvEvw.png" /></figure><p>格式如下：</p><blockquote>http://apps.apple.com/&lt;country&gt;/app/&lt;app–name&gt;/id&lt;store-ID&gt;</blockquote><p>更新之後 Approval status 就會自動從 “<strong>Requires review</strong>” 變成 “<strong>Getting ready</strong>”。審核通過後會收到 email 通知，這時候從實體裝置打開 App 就可以成功看到廣告啦～🙌</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yjJsc6sPjtGbkTo7j4jhvg.png" /></figure><h3>＊查看 AdMob 報告：</h3><p>在 App 送出 review 期間忽然收到 AdMob 通知說我的帳戶有 Invalid Activity，嚇得我趕緊上後台查看 traffic resources。</p><p>到 AdMob 後台的 Reports 頁面，選擇要查看的報告。（因為我只有使用 AdMob 串接廣告，故查看 AdMob Network 的報告就好）</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ru9Y3Mtd7m6ZCsDbvJleQg.png" /></figure><p>當時的 Ads Activity report 頁面：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*k5lqyVdgsyLB9pp-2j1Sgw.png" /></figure><p>(這個期間會使用到 App 的都是 App Reviewers~ 看來我的 reviewers 分別來自台灣/新加坡/美國🤣🤣)</p><p>爬文說 Invalid Activity 在檢查沒有其他異常（雖然但是，有沒有異常 admob 說了算😅）後就會恢復正常。後續我的 Admob 已經移除了警告，但可能還是有點影響，這個 app 的 match rate 一直都不高😭😭😭</p><h4>＊ Admob 通知要進行新加坡稅務申報</h4><p>等到過了 Payment thresholds （款項起付額度）再來思考這個問題吧 🤣 萬一真的到了那天(?)再來更新～</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5ff5169b07c2" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>