## 流程

1. S3 建立 Bucket, public 權限打開, 放入你的靜態網頁(index.html)

2. AWS Certificate Manager 申請 SSL (一定要在 virginia us-east-1 !!)

3. CloudFront 建立 Distribution, 並指向S3 Bucket.

4. S3 public 權限要關掉(如果沒用OAI的話)

• https://docs.aws.amazon.com/AmazonS3/latest/userguide/website-hosting-custom-domain-walkthrough.html
• https://aws.amazon.com/tw/blogs/security/how-to-protect-your-web-application-against-ddos-attacks-by-using-amazon-route-53-and-a-content-delivery-network/

## 1. S3 建立 Bucket

• Everyone Read 權限打開 不然沒人連的到網站
• 指定CloudFront cache 時間 https://docs.aws.amazon.com/zh_tw/AmazonCloudFront/latest/DeveloperGuide/Expiration.html
• 因為透過 Cloudfront 所以 Static website hosting 並不需要開啟

## 2. AWS Certificate Manager 申請 SSL

#### 使用DNS驗證

使用DNS驗證的話, AWS會自動幫你 renew憑證, 如果使用email的話這樣每年都要自己手動renew

有以下2種方式做認證, 看是要用AWS 的 Route 53 , 或是第三方的DNS供應商

1. 不是使用 Route 53 做為 DNS 供應商，

• 您必須擷取 CNAME 資訊並新增至 DNS 資料庫。您可以使用兩種方式的任一種執行此動作：

1. 複製顯示在 Domains（網域）部分的 CNAME 元件。這些資訊需手動新增至 DNS 資料庫。

2. 選擇 Export to CSV（匯出至 CSV）。結果檔案中的資訊需手動新增至 DNS 資料庫。

2. (選用) 使用 Route 53 進行驗證。

• Create records in Route 53（在 Route 53 中建立記錄）按鈕會在符合以下情況時顯示：
• 您使用 Route 53 做為 DNS 供應商。
• 您擁有寫入 Route 53 託管區域的許可。
• 您的 FQDN 未經驗證。

注意

如果 Create record in Route 53 (在 Route 53 中建立記錄) 按鈕遺失或停用，請參閱「ACM 主控台不會顯示「Create record in Route 53」(在 Route 53 中建立記錄) 按鈕」。

• 選擇 Create records in Route 53（在 Route 53 中建立記錄）按鈕，然後選擇 Create records（建立記錄）。所以此 Certificate status（憑證狀態）頁面應該開啟並顯示狀態橫幅報告 Successfully created DNS records（成功建立 DNS 記錄）。您的新憑證可能會繼續顯示 Pending validation（待定驗證）狀態最多 30 分鐘。

提示

您無法透過編寫程式的方式請求 ACM 自動在 Route 53 中建立記錄。但是您可以對 Route 53 發出 AWS CLI 或 API 呼叫，以在 Route 53 DNS 資料庫中建立記錄。如需有關 Route 53 記錄集的詳細資訊，請參閱使用 Route 53使用資源記錄集。

更詳細的話可以看官網的介紹 https://docs.aws.amazon.com/zh_tw/acm/latest/userguide/dns-validation.html

## 3. Cloudfront 建立 Distribution

這邊就要建立一個CDN, 然後對應到剛剛建立好的 S3 Bucket

1. `Origin Domain Name` 選擇剛剛建立的S3 Bucket

OAI

• 如果沒有 Origin Access Identity (OAI) 的話，Cloudfront 會透過這個 identity 來存取 S3, 所以在S3的 `Grant Read Permissions on Bucket` 這邊必須選擇 `Yes`, 這會自動 update S3 bucket policy, 這樣就允許 Cloudfront 讀取 origin bucket.
• 如果選擇OAI. bucket can restrict access to only CloudFron, 用在限制 user 只能透過 Cloudfront 讀取靜態網頁, 而不能直接 access S3 bucket.

If you don’t use an OAI, your S3 bucket must allow public access.

If you don’t want your S3 bucket to allow public access,

you can use an OAI. With an OAI, CloudFront sends authenticated requests to your S3 bucket.

This means you can block public access to your S3 bucket while still allowing CloudFront to get objects from the bucket.

To use an OAI, you must update your S3 bucket policy to allow access to the OAI.

When you choose Yes use OAI you can also choose Yes,

update the bucket policy so that CloudFront updates the bucket policy for you.

Otherwise, you must update it yourself.

2. `Viewer protocol policy` 勾 `Redirect HTTP to HTTPS`, 因為都用HTTPS了

3. cache 就走AWS建議的

4. 選剛剛驗證過的SSL

5. 更多設定可以參考 https://docs.aws.amazon.com/zh_tw/AmazonCloudFront/latest/DeveloperGuide/UpdatingExistingObjects.html

## Reference

• https://blog.johnwu.cc/article/aws-s3-cloudfront-ssl-%E9%9D%9C%E6%85%8B%E7%B6%B2%E9%A0%81%E6%9E%B6%E7%AB%99%E6%95%99%E5%AD%B8.html
• https://docs.aws.amazon.com/zh_tw/acm/latest/userguide/dns-validation.html
• https://docs.aws.amazon.com/zh_tw/AmazonCloudFront/latest/DeveloperGuide/Expiration.html
• https://docs.aws.amazon.com/zh_tw/AmazonCloudFront/latest/DeveloperGuide/UpdatingExistingObjects.html
• https://blog.david74.dev/%E4%BD%BF%E7%94%A8-aws-s3-cloudfront-%E9%83%A8%E5%B1%AC-custom-domain-https-%E9%9D%9C%E6%85%8B%E7%B6%B2%E9%A0%81-eddd9c9ad9d1

把參考物件的變數指向複製過的新物件, 而不是原有的物件.

值類型的數據, 默認是深複製, Array, Int, String, Float, Boolean, Struct 修改並不會改變原物件‌

Struct 的屬性如果是引用類型的話, 複製的是指針‌

淺複製 (Shallow Copy)

‌

被複製物件的所有變數都的值與原來的物件相同, 對其他物件的引用仍然只指向原來的物件‌

引用類型的數據, 默認是淺複製, Slice, Map, Channel

‌Wiki

https://en.wikipedia.org/wiki/Object_copying‌

Shallow copy

One method of copying an object is the shallow copy. In that case a new object B is created, and the fields values of A are copied over to B.[3][4][5] This is also known as a field-by-field copy,[6][7][8] field-for-field copy, or field copy.[9] If the field value is a reference to an object (e.g., a memory address) it copies the reference, hence referring to the same object as A does, and if the field value is a primitive type it copies the value of the primitive type. In languages without primitive types (where everything is an object), all fields of the copy B are references to the same objects as the fields of original A. The referenced objects are thus shared, so if one of these objects is modified (from A or B), the change is visible in the other. Shallow copies are simple and typically cheap, as they can be usually implemented by simply copying the bits exactly.‌

Deep copy

‌

A deep copy in progress.

A deep copy having been completed.

An alternative is a deep copy, meaning that fields are dereferenced: rather than references to objects being copied, new copy objects are created for any referenced objects, and references to these placed in B. The result is different from the result a shallow copy gives in that the objects referenced by the copy B are distinct from those referenced by A, and independent. Deep copies are more expensive, due to needing to create additional objects, and can be substantially more complicated, due to references possibly forming a complicated graph.‌

Deep copy is a process in which the copying process occurs recursively. It means first constructing a new collection object and then recursively populating it with copies of the child objects found in the original. In case of deep copy, a copy of object is copied in other object. It means that any changes made to a copy of object do not reflect in the original object. In python, this is implemented using “deep copy()” function.

Example in Go

可以看出在淺複製時, obj 和 cloneObj 記憶體位置都一樣 (address：0xc000100300). 所以cloneObj被修改後, 原先到object也會被更改

使用 Gitbook CLI 將 Markdown 的檔案編譯, 並藉由 GitHub Actions 自動部署到 GitHub Pages‌

設定流程‌

1. Personal access token‌

A. 申請 Personal access token‌

在右上角 Github 頭像 -> Settings -> Developer settings -> Personal access tokens -> Generate new token‌

勾選 repo:status public_repo‌

注意: 要保存好剛產生出來 token

B. 將 Personal access token 寫入至 repositories 的 Secrets

在你的 repositories Settings -> Secrets -> New repository secre‌

將上一步驟的 token 寫入, 並命名 GH_ACCESS_TOKEN

2. 建立 GitHub Actions YAML

‌新增 GitHub Actions 的腳本在此路徑:.github/workflows/build.yml

‌此腳本功能是當你 push code 至 main branch 時, 會執行 jobs 的指令, 藉由 Gitbook CLI 將檔案 build 到 gh-pages 此 branch 的 _book 資料夾‌

需修改你想要的 branches, MYEMAIL

3. GitHub Pages 設定‌

在你的 repositories Settings->Pages‌

Source 的 Branch 選 gh-pages

4. 測試腳本‌

在你的 repositories Actions -> Workfows -> Run workflow‌

他就開始跑 yml 腳本, 可以點進去看他執行的 log

Gitbook 指令, 插件

如果要在本地端使用的話

install gitbook package

npm install -g gitbook

npm install -g gitbook-cli‌

fix: /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287 if (cb) cb.apply(this, arguments)

cd /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/

npm install graceful-fs@4.2.0 --save‌

gitbook commands‌

generate SUMMARY.md

book sm -i _book node_modules‌

start service

gitbook serve .‌

build static file

gitbook build --output=/build/recipe‌

可以將想要的插件寫在 book.json -:代表停用此plugin

{"plugins": [ "-search", "-lunr", "search-plus"]}

‌如果是本地端要測試的話, 需執行 gitbook install‌

可以參考這裡https://gitbookio.gitbooks.io/documentation/content/format/plugins.html‌

範例連結

• Gihub連結
• Gihub pages

‌Reference

• https://wastemobile.gitbooks.io/gitbook-chinese/content/book/gitbook-cli.html
• https://github.com/wangzhebufangqi/auto-export-gitbook
• http://www.chengweiyang.cn/gitbook/github-pages/README.html
• https://www.cnblogs.com/snowdreams1006/p/12023904.html
• https://blog.csdn.net/qq_40889820/article/details/110013310

‌

You can paste result into keynote.

ps. source code to image, online tool https://carbon.now.sh/

Installation

brew install highlight‌

Examples

1. Show result in terminal

highlight -O rtf -S go -K 24 -k Courier-Bold -s Moria main.go -l

argument

http://www.andre-simon.de/doku/highlight/en/highlight.php

-O, --out-format=<format>      output file in given format

<format>=[html, xhtml, latex, tex, odt, rtf,

ansi, xterm256, truecolor, bbcode, pango, svg]

-S, --syntax=<type|path>       specify type of source code or syntax file path

--syntax-by-name=<name>    specify type of source code by given name

will not read a file of this name, useful for stdin

-K, --font-size=<num?>         set font size (specific to output format)

-k, --font=<font>              set font (specific to output format)

-s, --style=<style|path>       set colour style (theme) or theme file path

-l, --line-numbers             print line numbers in output file

‌more style samples

http://www.andre-simon.de/doku/highlight/en/syntax-samples.php

2. Output result into your clipboard

highlight -O rtf -S go -K 24 -k Courier-Bold -s Moria main.go -l | pbcopy

3. Create command as : hpas‌

You can copy your code and run command hpas go. It will auto generate highlight code, then paste it to keynote or other.‌

1. create a file name hpas

pbpaste | highlight -O rtf -S $1 -K 24 -k Courier-Bold --style Moria -l | pbcopy

2. run vi ~/.zshrc

export PATH="$PATH:/Users/kimiimac/myscript"

3. run source ~/.zshrc

Result

‌

Reference

• http://www.andre-simon.de/doku/highlight/en/highlight.php
• https://gitlab.com/saalen/highlight/-/wikis/CSS-Themes
• https://carbon.now.sh/

Hot Reload 方便修改程式後, 讓程式自動編譯並執行. 省去每次手動編譯與執行.‌

記錄一下目前自己使用過的三個套件Air, Fresh, Realize‌

1. Air (https://github.com/cosmtrek/air)‌

• 較推薦使用此套件
• 原先是使用 fresh, 但是遇到fresh不能在執行指令後面帶參數.‌

features‌

• Colorful log output
• Customize build or binary command
• Support excluding subdirectories
• Allow watching new directories after Air started
• Better building process‌

Installation

# binary will be $(go env GOPATH)/bin/air

curl -sSfL https://raw.githubusercontent.com/cosmtrek/air/master/install.sh | sh -s -- -b $(go env GOPATH)/bin

# or install it into ./bin/

curl -sSfL https://raw.githubusercontent.com/cosmtrek/air/master/install.sh | sh -s

air -v‌

Usage

# 初始化設定檔

air init

# 預設找 .air.toml 此設定檔

air

# 選擇要執行的設定檔

air -c .air.toml

# Debug

air -d

‌sample config

• https://github.com/cosmtrek/air/blob/master/air_example.toml‌

我的設定檔

# Config file for [Air](https://github.com/cosmtrek/air) in TOML format

# Working directory

# . or absolute path, please note that the directories following must be under root.

root = "."

tmp_dir = "tmp"

[build]

# Just plain old shell command. You could use `make` as well.

cmd = "go build -o ./tmp/main ."

# Binary file yields from `cmd`.

bin = "tmp/main"

# Customize binary.

full_bin = "APP_ENV=dev APP_USER=air ./tmp/main"

# Watch these filename extensions.

include_ext = ["go", "tpl", "tmpl", "html", "css", "js", "env", "yaml"]

# Ignore these filename extensions or directories.

exclude_dir = ["assets", "tmp", "vendor", "node_modules", "build"]

# Watch these directories if you specified.

include_dir = []

# Exclude files.

exclude_file = []

# Exclude unchanged files.

exclude_unchanged = true

# This log file places in your tmp_dir.

log = "air.log"

# It's not necessary to trigger build each time file changes if it's too frequent.

delay = 1000 # ms

# Stop running old binary when build errors occur.

stop_on_error = true

# Send Interrupt signal before killing process (windows does not support this feature)

send_interrupt = false

# Delay after sending Interrupt signal

kill_delay = 500 # ms

[log]

# Show log time

time = false

[color]

# Customize each part's color. If no color found, use the raw app log.

main = "magenta"

watcher = "cyan"

build = "yellow"

runner = "green"

[misc]

# Delete tmp directory on exit

clean_on_exit = true‌

2. Fresh (https://github.com/gravityblast/fresh)

• 目前看起來沒在更新了
• 沒法在指令後面帶入參數
• 如果go build返回錯誤, 會將記錄在tmp資料夾中‌

Installation

go get github.com/pilu/fresh‌

Usage

fresh

# 選擇要執行的設定檔

fresh -c other_runner.conf

sample config

root:              .

tmp_path:          ./tmp

build_name:        runner-build

build_log:         runner-build-errors.log

valid_ext:         .go, .tpl, .tmpl, .html

no_rebuild_ext:    .tpl, .tmpl, .html

ignored:           assets, tmp

build_delay:       600

colors:            1

log_color_main:    cyan

log_color_build:   yellow

log_color_runner:  green

log_color_watcher: magenta

log_color_app:

3. realize (https://github.com/oxequa/realize)‌

features

• High performance Live Reload.
• Manage multiple projects at the same time.
• Watch by custom extensions and paths.
• All Go commands supported.
• Switch between different Go builds.
• Custom env variables for project.
• Execute custom commands before and after a file changes or globally.
• Export logs and errors to an external file.
• Step-by-step project initialization.
• Redesigned panel that displays build errors, console outputs and warnings.

‌

總結‌

目前較推薦使 air , fresh 遇到無法帶入參數, 且可設定的東西較少決了. realize 忘了之前是mod還是vendor無法安裝, 不知道解了沒.

‌

Reference‌

• https://github.com/cosmtrek/air
• https://github.com/gravityblast/fresh
• https://github.com/oxequa/realize

官方安裝文件

‌

最詳細的安裝說明, 請直接看官網: https://dortania.github.io/OpenCore-Install-Guide/

我做好的EFI: https://github.com/kimi0230/ASUS-Z170M-PLUS-Skylake-Hackintosh

摘要

‌

此篇文章主要記錄‌

• 安裝黑蘋果的流程
• 相關設定的對應連結
• usb port客製
• 需要下載的軟體‌

其實直接買 Mac mini 比較爽

最後有Github 連結存放 EFI‌

硬體需求

‌

https://dortania.github.io/Anti-Hackintosh-Buyers-Guide/‌

• CPU : 使用 intel cpu 比較輕鬆
• SSD: m2 ssd 需要挑選某幾個型號, 我使用 wd blue sn550 1t
• VGA: 挑AMD某幾個型號, 我使用RX5500
• WIFI: 建議買 BCM94360CD, wifi, 藍芽皆有. 免驅動還可以使用airdrop‌

BIOS設置

Disable

• 快速啟動
• VT-d（如果將DisableIoMapper設置為YES，則可以啟用）
• CSM
• Thunderbolt
• Intel SGX
• Intel Platform Trust
• CFG鎖（MSR 0xE2寫保護）
• 如果無法在BIOS中關閉（甚至找不到），請考慮對其進行修補。有關更多信息，請參見固定CFG鎖。 AMD CPU用戶無需擔心。‌

Enable

• VT-x
• 4G以上解碼
• Hyper-Threading
• Execute Disable Bit
• EHCI/XHCI Hand-off
• 操作系統類型：Windows 8.1 / 10 UEFI模式
• 舊版RTC設備（與Z370 +相關）

‌

安裝流程

00. OpenCore 基本文件架構

Enter a caption for this image (optional)

01. 作業流程

• 下載好的OC引導文件，把Doc文件夾下面的 SampleFull.plist 改名為 config.plist，並把此文件移動到EFI目錄裡面
• 打開EFI ㄧ> Kexts 資料夾，把主機板相關硬體的kexts 先放進去
• OC－ACPI、Drivers、Kexts、Tools 已經內建許多工具，我們只保留自己所需要的工具即可。
• ACPI：加入修補程式, SSDT
• USB 引導

會動到的資料夾跟檔案

• OC/Kexts
• OC/ACPI
• OC/config.plist

‌

主要會用的軟體

• DSDT/SSDT 反編譯工具: isal
• 編輯config.plist用, 擇一: opencore configurator 或 ProperTree
• 產生mac 序號: GenSMBIOS
• 掛載EFI, 用在製作usb或事後修改系統的EFI: MountEFI
• 安裝好黑蘋果後可看一些設定: Hackintool

02. Kexts

https://dortania.github.io/OpenCore-Install-Guide/ktext.html#kexts

• kernel 的擴充, 根據你的主機板決定要導入哪些kexts
• SBInjectAll : oc上面提到 “ Shouldn’t be needed on Desktop Skylake and new “, 但在安裝畫面usb皆無反應, 建議usb無法使用時將此補上
• 下載Kexts放入 OC/Kexts‌

檔案下載: https://bitbucket.org/profdrluigi/kextupdater/downloads/

‌

03. OC/ACPI (SSDT)‌

https://dortania.github.io/Getting-Started-With-ACPI/‌

• 根據cpu決定要導入哪些必要的SSDT
• 產生ssdt文件工具 https://github.com/corpnewt/SSDTTime
• 將ssdt檔案放入 OC/ACPI

Enter a caption for this image (optional)

04. config.plist 設定‌

https://dortania.github.io/OpenCore-Install-Guide/config.plist/#creating-your-config-plist

‌

• 使用 opencore configurator 或 ProperTree 來編輯檔案
• 依據你的CPU, 主機板, 顯示卡來設定你的config
• 使用 GenSMBIOS 產生序號
• SMBIOS ID, Platform ID 快速查詢
• 或者從官網看要選哪種 https://dortania.github.io/OpenCore-Install-Guide/extras/smbios-support.html#how-to-decide

• 檢查序號是否有人使用 https://checkcoverage.apple.com/tw/zh/

ASUS Z170M-PLUS(realtek 887) Audio ID = 1 Skylake: iMac17,1

‌

• 最後檢查 Config 是否有誤 https://opencore.slowgeek.com/

‌

05. 導引製作/安裝‌

https://dortania.github.io/OpenCore-Install-Guide/installer-guide/#creating-the-usb‌

1. 打開磁碟工具。從左邊的欄位找到要製作USB引導碟的『主體』。選擇『清除』，選擇格式：Mac OS 擴充格式（日誌式），架構為GUID分區圖配置表，名稱暫時為USB https://www.macobserver.com/tips/quick-tip/how-to-format-drive-guid/
2. 安裝macOS映像檔：

APP store 下載 https://support.apple.com/en-us/HT201372

打開終端機輸入

• sudo /Applications/Install\ macOS\ Big\ Sur.app/Contents/Resources/createinstallmedia — volume /Volumes/MyVolume

06. 將efi放入製作好usb導引‌

• 使用 MountEFI 掛載檔案, 就可以把你的efi放入‌

07. 訂製USB Ports

• 為了避免機器睡眠會有問題(機率很小), 需要訂製一下usb的port
• 使用Hackintool: 準備usb2.0跟3.0的裝置如隨身碟, 將裝置插入電腦看看tool是哪個位置偵測到,並對此位置做修改
• 詳細請參考 【司波图】10代CometLake平台黑苹果Opencore6.0下的声卡驱动&USB定制

‌

EFI : ASUS-Z170M-PLUS-Skylake‌

• https://github.com/kimi0230/ASUS-Z170M-PLUS-Skylake-Hackintosh

‌

其他問題

• Apple TV 無法播放: https://github.com/acidanthera/WhateverGreen/blob/master/Manual/FAQ.Chart.md
• iMovies 無法匯出檔案

change iMac17,1 to iMac19,1

Reference‌

• https://dortania.github.io/OpenCore-Install-Guide/
• https://heipg.cn/tutorial/smbios-id-and-details.html
• https://heipg.cn/tutorial/custom-usbports-for-hackintosh.html
• https://www.imacpc.net/archives/3340
• https://www.macobserver.com/tips/quick-tip/how-to-format-drive-guid/
• https://medium.com/ishengp-laboratory/ishengp-catalina-opencore-80be977427ae
• https://www.kancloud.cn/chandler/mac_os/480624
• [youtube] 【司波图】10代CometLake平台黑苹果Opencore6.0下的声卡驱动&USB定制
• [youtube] Intel Coffee Lake平台完美黑苹果系统安装教程（Opencore+Catalina15.4）

‌

目的

利用 iOS 的 shortcut, 自動執行 Spotify 特定歌單或專輯. 或者藉由 siri 播放特定歌曲.‌

取得 Spotify access token

可參考 doc 的 Authorization Guide (https://developer.spotify.com/documentation/general/guides/authorization-guide/)

‌1. 到 Spotify dev 申請一個APP

My Dashboard | Spotify for Developers

填好資料後, 記住 Client ID 和 Secret.

2. 點擊 EDIT SETTINGS, 在 Redirect URIs 這欄填入隨便自己的一個 Github 網址

3. 將剛剛 GitHub URL encode 一下, 藉由此網址

URL Encode and Decode - Online

4. 選則該 token可以使用的權限(Scopes)

Authorization Scopes | Spotify for Developers

我選了這幾個. 記住中間都使用一個空白隔開

playlist-read-private user-modify-playback-state user-read-playback-state

5. 將前面幾步驟的東西組成一個網址, 貼到瀏覽器

https://accounts.spotify.com/authorize?client_id={第1步取得的Client ID}&response_type=code&redirect_uri={第3步encode的github url}&scope={第4步的scopes}

6. 按下同意, 會導向先前填的 Github 網址, 並且後面會出現code=”xxxx”

7. 組出 API header Authorization 格式

第一步的Client ID:第一步的Client Secret

並用此網址來做 base64 encode

Base64 Encode and Decode - Online

8. 可以開始打申請 Token 的API了～用 Postman 或者 Terminal 的 curl 來打. 並記住refresh_token 跟 access_token

curl --location --request POST 'https://accounts.spotify.com/api/token' \

--header 'Authorization: Basic {第7步的 API  header  Authorization 格式}' \

--header 'Content-Type: application/x-www-form-urlencoded' \

--data-urlencode 'grant_type=authorization_code' \

--data-urlencode 'code={第6步取得的 code}' \

--data-urlencode 'redirect_uri={你的github url}'

可參考 ‌Spotify doc

request 參數

Respone 參數

因為access_token, 有效期限只有3600秒. 所以要記住 refresh_token. 藉由refresh_token重新去要access_token

撰寫 IOS Shortcut‌

1. 呼叫API:從refresh_token取得新的access_token

https://www.icloud.com/shortcuts/29dba791327c42e9bdbdf13fcac86355

有三個變數需要帶入: 在”文字”上面分別填入第8步的 refresh_token與 先前的client_id, secret.

2. 呼叫API:取得現在正在執行spotify的裝置id (device_id) . 這個捷徑是取正在行動裝置上執行的ID

Shortcuts

3.呼叫API: 設定是否隨機播放API

Shortcuts

4. 呼叫API: 播放指定歌單, 目前設定此歌單(https://open.spotify.com/playlist/1AL0bu2zPr1GXn4TE9toBU?si=akwdzQ_sRRShCAL2bPlqng)

Spotify uri 為: spotify:playlist:1AL0bu2zPr1GXn4TE9toBU

Shortcuts

要更換歌單可以修改context_uri

5. 整合上面的捷徑

Shortcuts

步驟1取的token. 打開 iPhone 的 Spotify app. 目的是為了讓後面的取得 devcie id API 可以使用

步驟2取得device id

‌

將 device id 跟 access token 帶入辭典. 此變數可以給步驟3跟 步驟4的捷徑使用. state: true代表隨機播放

6.設定完之後可以在自動化那邊新增鬧中停止時觸發捷徑, 或者對著 Siri 大聲喊 Danny go demo (你的捷徑名稱). 就可以自動執行腳本了!

Reference

https://medium.com/%E6%B5%B7%E5%A4%A7-ios-app-%E7%A8%8B%E5%BC%8F%E8%A8%AD%E8%A8%88/%E4%B8%B2%E6%8E%A5%E5%A4%9A%E7%A8%AE-api-%E8%A3%BD%E4%BD%9Clady-gaga-app-spotify%E7%AF%87-2d39c52da7e4

‌https://www.igeeksblog.com/best-spotify-siri-shortcuts/

‌

‌

解決開發 API 文件, 但又不想花時間同時開發跟維護文件. 加個欄位還要跑去改文件.

Swagger 可快速產生API文件. 且多個程式語言皆有支援

• Swaggo/swag 是由Golang撰寫, 且支援
• gin
• echo
• buffalo
• net/http
• flamingo
• fiber

‌此範例使用 gin 來實作. 藉由註解, Swagger就能產文件.依據格式寫出來的註解可對應到文檔說明

安裝 package (gin, swagger)

gin

go get -u github.com/gin-gonic/gin

swagger

go get -u github.com/swaggo/swag/cmd/swag

Demo範例,資料夾結構

├── Readme.md
├── app
│   ├── controllers
│   │   └── api
│   │       ├── test
│   │       │   └── test.go
│   │       └── v1
│   │           └── account
│   │               └── account.go
│   ├── models
│   │   ├── account.go
│   │   └── error.go
│   └── services
│       └── httputil
│           └── error.go
├── docs
│   ├── docs.go
│   ├── swagger.json
│   └── swagger.yaml
├── main.go
├── routes
│   └── routes.go
└── tmp
└── runner-build

導入 swagger 文檔, package, 匯入路由

main.go

Debug Mode 才將 Swagger 路由導入

Swagger 註解

Swagger 是藉由註解內容來產生文件的, 在main.go上面是一般API訊息. 每個api func 上面註解用來顯示使用方法,需要哪些參數,回傳結果等等

‌一般API訊息

title         簡單API專案的標題或主要的業務功能
version         目前這專案API的版本
description 簡單描述
tersOfService 服務條款
tag.name 標籤名稱
tag.description 標籤描述
tag.docs.url 標籤的外部文檔URL
tag.docs.description 標籤的外部文檔說明
contact.name 作者名稱
contact.url 作者網址
contact.email 作者email
license.name 許可證名稱
license.url 許可證網址
host         服務名稱或者是ip
BasePath 基本URL路徑, (/api/v1)
schemes         提供的協定, (http, https)

使用＠開頭當變數 後面的值需使用一個空白

main.go

/*
@title Swagger Example API With Gin
@version 1.0
@description This is a sample server celler server.
@termsOfService http://swagger.io/terms/
@contact.name API Support
@contact.url http://www.swagger.io/support
@contact.email support@swagger.io
@license.name Apache 2.0
@license.url http://www.apache.org/licenses/LICENSE-2.0.html
@host localhost:5566
@BasePath /api/v1
@query.collection.format multi
@x-extension-openapi {"example": "value on a json format"}
*/

func main() {...}

API操作

description	操作行為的詳細說明
summary	描述該API
id	用於標示API的唯一字符,在所有API操作中必須唯一。
tags	歸屬同一類的API的tag, 以逗號分隔
accept	request的context-type
produce	response的context-type
param	參數按照: `參數名` `參數類型` `參數的資料類型` `是否必填` `註解`
header	response header: `return code` `參數類型` `資料類型` `註解`
router	path httpMethod

app/controllers/api/v1/account/account.go

// AddAccount godoc
// @Summary X01 Add an account
// @Description add by json account
// @Tags accounts, accounts2
// @Accept  json
// @Produce  json
// @Param account body models.AddAccount true "Add account"
// @Success 200 {object} models.Account
// @Failure 400 {object} httputil.HTTPError
// @Failure 404 {object} httputil.HTTPError
// @Failure 500 {object} httputil.HTTPError
// @Router /accounts [post]

func AddAccount(c *gin.Context) {...}

參數類型

https://github.com/swaggo/swag#param-type

• query
• path
• header
• body
• formData

‌Data類型

https://github.com/swaggo/swag#param-type

• string (string)
• integer (int, uint, uint32, uint64)
• number (float32)
• boolean (bool)
• user defined struct

Mime Types

https://github.com/swaggo/swag#mime-types

屬性

https://github.com/swaggo/swag#attribute

定義回傳結構

app/models/account.go

app/services/httputil/error.go

重新產生Swagger 文件

swag init

啟動 Gin Server

go run main.go

API Doc 連結

http://localhost:8080/swagger/index.html

完整範例

https://github.com/kimi0230/swagger_gin_demo

‌

參考

• swaggo/swag

‌使用sequel pro 匯出excel時, 遇到了欄位名稱跑掉等等問題．故直接寫一個匯出功能, 藉由Gorm 撈取Mysql 資料, 並寫入Excel.

‌安裝

go get -u github.com/360EntSecGroup-Skylar/excelize
go get -u github.com/jinzhu/gorm

‌檔案結構

‌設定.env

此設定給mysql/mysql.go 連線使用

## Database

DB_CONNECTION=mysql

DB_HOST=

DB_PORT=3306

DB_DATABASE=

DB_USERNAME=

DB_PASSWORD=

‌建立excel

編譯

go build excelize_demo.go

‌使用方法

./excelize_demo -f {file name}

./excelize_demo -f kimi

Excel 相關設定

• https://xuri.me/excelize/zh-tw/workbook.html#CopySheet

Reference

• https://github.com/360EntSecGroup-Skylar/excelize
• https://xuri.me/excelize/zh-tw/workbook.html#CopySheet

‌

問題

‌如果同一個路由又用 router 導向同一個路由會遇到下面的錯誤

vue-router.esm.js?8c4f:2089 Uncaught (in promise) NavigationDuplicated {_name: “NavigationDuplicated”, name: “NavigationDuplicated”, message: “Navigating to current location (“/reservation/create”) is not allowed”, stack: “Error↵ at new NavigationDuplicated (webpack-int…node_modules/vue/dist/vue.runtime.esm.js:1853:26)”}

‌原因

‌vue-router 3.1後 push 和 replace方法返回 promise, promise 被 reject 但是沒有 catch，導致報錯 Uncaught. 3.1版本之前是通過傳回調函數捕獲錯誤, 沒有回調就不會捕獲也不會報錯

‌官方issue: https://github.com/vuejs/vue-router/issues/2881#issuecomment-520554378

‌解法

方法1.使用 go(0)

router.go(n) 這個方法的參數是一個整數, 意思是在 history 記錄中向前或者後退多少步, 類似 window.history.go(n)。

this.$router.go(0);

這做法有個問題, 他會重新整理頁面, 所以會導致 vuex 裡面存的資料被刷掉.

方法2.先跳到某頁, 再跳回來

‌新增一個vue檔案, Refresh.vue

用來跳回原本路徑.‌

在 vue router 補上剛剛建立的Refresh.vue‌

導頁時補上, 當 catch 到 err 時, 就會跑到 Refresh, 再導回來.

參考

• https://forum.vuejs.org/t/navigationduplicated/71600/2
• https://router.vuejs.org/guide/essentials/navigation.html#router-go-n
• https://github.com/vuejs/vue-router/issues/2881#issuecomment-520554378