2021年8月30日

在 Windows 上配對 Apple 鍵盤時需要輸入 PIN 碼(Apple keyboard PIN)

keywords: Mac 鍵盤PIN 碼Magic KeyboardWindows巧控鍵盤
最近在把 Magic Keyboard 和 Windows 筆電配對時發生一件很奇怪的事,就是當我點擊「連結」時,它一直要求我「輸入『鍵盤』的 PIN」,但重點是,螢幕上沒有跳出任何告知我鍵盤 PIN 碼的畫面,我也不知道鍵盤的 PIN 碼到底什麼是什麼。
後來找到了這篇文章(How do I pair apple wireless keyboard with windows 10),和底下留言的人說的一樣,這個解法非常荒謬,但它真的有效!
後來我發現,原來在 Windows 配對 Magic Keyboard 時,重點是配對時需要在電腦上先隨意輸入一組 PIN 碼,接著再用 Apple 的鍵盤輸入同樣的 PIN 碼後按 Enter 就可以了,像是這樣:
  1. 先讓你的鍵盤可以被電腦搜尋到,然後在電腦上點擊「新增藍芽或其他裝置」
  2. 選擇「藍芽」找到鍵盤後,點擊「連結」
  3. 這時候它會要求你「輸入『鍵盤』的 PIN」,這時候用「電腦原本的鍵盤」輸入任意一組數字(例如,12345678)
  4. 輸入完後用滑鼠點擊「連結」,電腦會好像在等待什麼一樣
  5. 接著在「Apple 鍵盤」上輸入和剛剛輸入相同的 PIN 碼,然後按下鍵盤的 Enter
邏輯上,這樣應該就搞定了。

2021年8月14日

認識 TypeScript 中的型別魔術師:Mapped Type

TypeScript Mapped Type
在 TypeScript 中,Mapped Type 是一個非常有趣的東西,一開始可能會覺得有點抽象,但一旦熟悉了它的概念後,Mapped Type 就像是「型別魔法師」一樣,可以根據型別組合出各種不同的型別,也就是說如果想要能夠靈活建立 Type 的話,Mapped Type 是一個一定要會的概念。

Index Signatures Type

在了解 Mapped Type 之前,需要先來看一下它的前身 Index Signatures Type。一般來說,在 TypeScript 裡定義物件的型別會需要把物件的每一個 key 和 value 的型別都定義清楚,像是這樣:
type Person = {
  firstName: string;
  lastName: string;
  age: number;
};
但有些時候,因為一些原因,也許是 key 的名稱不是那麼重要時,或者 key 的可能太多事,我們可以使用 index signature type 來定義這個物件,例如,定義一個 key 為 string,value 則為 stringnumber 的型別:
type PersonDict = {
  // "key" 可以是取成任何名稱
  [key: string]: string | number;
};
[key: string] 中的這個 key 可以是任何名稱,你也可以改成 [property: string] 效果是一樣的。

Mapped Type 和 in operator

在了解 index signatures type 後,就可以來初步認識 Mapped Type。而在 Mapped Type 中最重要的就是 in 這個關鍵字的使用。
先來看看 in 怎麼用:
type PersonMap = {
  [key in 'firstName' | 'lastName']: string;
};
這裡和 index signatures 類似,你一樣會看到像是 [key: ... ] 這樣的寫法,key 一樣是可以自己取的變數名稱,而不一樣的是多了 in 這個關鍵字。
這個 in 的感覺非常「類似」在 JavaScript 中 Array 的 for...of 方法,上面的 [key in 'firstName' | 'lastName'] 可以想成是這樣的感覺:
// Mapped Type 中的 [key in 'firstName' | 'lastName'],很類似於 for...of 的方法
for (const key of ['firstName', 'lastName']) {
  console.log(key);
}
for (const key of ...) 中,這個 key 會是每次疊代時陣列取得的元素值,所以這裡的話第一次會是 firstName,第二次會是 lastName
回到 Mapped Type 中的 [key in 'firstName' | 'lastName'],這裡的 key 也是很類似的概念,可以想像成會跑一個迴圈,第一次 key 的值會是 firstName,第二次的值則是 lastName
也就是說,上面的:
type PersonMap = {
  [key in 'firstName' | 'lastName']: string;
};
其實就是:
type PersonMap = {
  firstName: string;
  lastName: string;
};
Tip:
把 Mapped Type 中的 key in ... 想成是類似 for (const key of ...) 的概念,是我認為理解 mapped type 最重要的一步。它都有跑一個迴圈把所有元素依序取出來的概念。
由於 key 只是一個變數名稱,它也可以命名成其他名稱,又因為它表示的是物件屬性(property),所以也很常會用 P 來表示它,例如下面建立另一個 mapped type:
type Device = {
  [P in 'apple' | 'samsung' | 'google']: string;
};
如果了解剛剛的說明的話,應該可以想到,這裡 P 就會依序是 applesamsungpixel,出來的型別會等同於:
type Device = {
  apple: string;
  samsung: string;
  pixel: string;
};
這裡你也可以理解到 mapped type 和 indexed signature 的差別,mapped type 可以視為是 indexed signatures 的子集合(subset),它能將物件的屬性定義的更明確,而不是單純用某個型別來表示:
// index signatures:物件的屬性只要是 string 即可
type DeviceDict = {
  [key: string]: string;
};

// mapped type:物件的屬性需要是 'apple' | 'samsung' | 'google'
type DeviceMap = {
  [P in 'apple' | 'samsung' | 'google']: string;
};
單純看到這裡,可能還是感受不到為什麼會說 Mapped Type 是可以用來操作型別的「型別魔術師」,只會覺得 Mapped Type 單純只是可以「跑回圈」用的。
要讓 Mapped Type 發揮它強大的功力前,還需要了解另外一個重要的東西是 Keyof Type Operator

Keyof Type Operator

keyof 的作用其實很直觀,就是把物件的 key 給取出來:
type Person = {
  firstName: string;
  lastName: string;
  age: number;
  isMarried: boolean;
};

type PersonKeys = keyof Person;
基本上這個 PersonKeys 就會是所有 Person 物件 Key 的聯集,這裡就是 firstName | lastName | age | isMarried
TypeScript keyof
Tip:
在 TypeScript 中,object key 的型別可能是 stringnumbersymbol,所以如果使用 keyof any 得到的型別就會是 string | number | symbol

Mapped Type 搭配 keyof 的組合技

再了解 Mapped Type 和 Keyof Operator Type 之後,就可以使用這兩個的組合技。

範例一

假設現在我們定義了一系列的事件:
type SupportedEvent = {
  click: string;
  change: string;
  keyup: string;
  keydown: string;
};
這時候如果想根據 SupportedEvent 中屬性的名稱,產生一個新的型別叫做 HandledEvent,但物件 value 的型別要全部換成 function 的話,我們當然可以如同過去一個一個把屬性定義出來:
type HandledEvent = {
  click: () => void;
  change: () => void;
  keyup: () => void;
  keydown: () => void;
};
但這麼做除了很麻煩之外,未來如果有新增支援的事件類型到 SupportedEvent 的話,還需要同時記得加到 HandledEvent 這個型別中,如果忘記加的話,兩個型別中支援的 Event 類型就會不一致。
這時候使用 Mapped Type 搭配 keyof 就會非常的方便:
type HandledEvent = {
  [K in keyof SupportedEvent]: () => void;
};
寫成這樣就搞定了,未來如果 SupportedEvent 中有新增的事件類型是,HandledEvent 也不需要額外改動。
現在來了解一下我們剛剛的組合技是怎麼使用的。
首先要注意到的是 [K in keyof SupportedEvent]
  • 前面有提到 K 只是一個變數名稱,會對應到的是 in 後面每次取出來的值。
接著把注意力放到 in 後面的內容,它是 keyof SupportedEvent
  • 搭配前面對於 keyof 的理解,可以知道 keyof SupportedEvent,對應到也就會是 click | change | keyup | keydown
也就是說如果換成 JavaScript for ... of 的方法,它會像是這樣:
//  [K in keyof SupportedEvent]
for (const K of ['click', 'change', 'keyup', 'keydown']) {
  /* ... */
}
這樣你就可以知道,K 其實對應到的就會是 clickchangekeyupkeydown
再來是 [K in keyof SupportedEvent]: () => void;: 後的內容就會是物件 value 的型別。因為我們想要把它改成 function,所以就在後面放了 () => void

範例二

讓我們來看另一個 Mapped Typed + keyof 的例子,假設我們現在定義了一個 PersonMethod,它的 value 可能有很多不同的型別:
type PersonMethod = {
  greet: (name: string) => string;
  age: number;
  isMarried: boolean;
  name: string;
};
這時候需要定義一個 PersonMethodOptions 的型別,它的屬性名稱會和 PersonMethod 相同,但 value 的型別都是 boolean,用來表示要不要開關這個功能,這時候如果不會使用 Mapped Type 的話,我們可能會一個一個將屬性重複定出:
type PersonMethodOptions = {
  greet: boolean;
  age: boolean;
  isMarried: boolean;
  name: boolean;
};
如同前一個範例一樣,一旦 PersonMethod 中有添加新的方法,你就需要把這個方法也記得添加到 PersonMethodOptions,否則就會有不一致的情況。
但如果會使用 Mapped Type 搭配 keyof 的話,只要這樣就可以搞定了:
type PersonMethodOptions = {
  [P in keyof PersonMethod]: boolean;
};
至於為什麼這樣寫就可以,可以按照前一個範例的說明,試著思考看看。

P 不只是變數

在剛剛上面的範例中,我們分別使用了:
type HandledEvent = {
  [K in keyof SupportedEvent]: () => void;
};

type PersonMethodOptions = {
  [P in keyof PersonMethod]: boolean;
};
不論是 KP 有說到它都只是個變數名稱,要取名成什麼都可以,但實際上它也不單單只是個名稱,它還可以被拿來使用,舉例來說,我們可以把它當成 : 後的型別,像是這樣:
type HandledEvent = {
  // : 後面使用 K
  [K in keyof SupportedEvent]: K;
};

type PersonMethodOptions = {
  // : 後面使用 P
  [P in keyof PersonMethod]: P;
};
至於對應出來的型別結果會是什麼,大家可以自己嘗試看看,相信會可以加深你對 Mapped Type in 這個關鍵字的理解。

進階:使用 as 把物件 key 的名稱也做轉換

剛剛上面的範例中,我們大部分是保留原本物件的屬性名稱,只針對物件 value 的型別作轉換,但實際上,我們甚至也可以去轉換物件 key 的名稱。這裡會用到 TypeScript 中 Template Literal Typesas 的概念。
Template Literal Types 可以簡單想成就是 JavaScript 中的 template literal,也就是可以透過反引號(`)來在字串中帶入變數。
as 則可以讓我們在 Mapped Type 中改變物件 key 的名稱。
以上面我們用過 SupportedEvent 當作範例:
type SupportedEvent = {
  click: string;
  change: string;
  keyup: string;
  keydown: string;
};
在 React 中,很常會使用 handleXXX 來作為方法的命名,這時候如果想要根據 SupportedEvent 的屬性 key ,但產生的是新的 keyName,變成都是以 handle 當作前綴時,除了可以自己一個一個打,像下面這樣之外:
type HandleEvent = {
  handleClick: () => void;
  handleChange: () => void;
  handleKeyup: () => void;
  handleKeydown: () => void;
};
也可以利用 Mapped Type 的觀念,這樣寫就可以了:
type HandleEvent = {
  [P in keyof SupportedEvent as `handle${Capitalize<P>}`]: () => void;
};
如此也不用擔心未來 SupportedEvent 用新的 Type 加進去卻忘了補進 HandleEvent 的情況。
要理解上面的語法,一樣可以一步一步來,首先知道 P 是一個變數名稱,它可以拿到的是每次疊代時 keyof 後的內容,接著 as 的意思是我要把這個物件的 key 換一個名稱,換成的名稱是 `handle${Capitalize<P>}`
首先因為 P in keyof SupportedEvent ,所以你會知道 P 其實就是 clickchangekeyupkeydown
as 後面則是我們希望的新名稱是什麼,如果我們只是寫 `handle${P}` 的話,轉出來的 key name 會是 handleclickhandlechangehandlekeyuphandlekeydown,但因為我們希望 handle 後的第一個字母要大寫,所以這個範例中有用了 TypeScript 內建的 Capitalize 這個 type utility,它的作用是幫我們把 P 的第一個字變成大寫,於是轉出來的 key 名稱就會是我們想要的 handleClickhandleChange、...。

後記

這裡提到的只是 Mapped Type 搭配 keyof 做出的變化,Mapped Type 也很常會搭配 Indexed Access TypeCondition Types 做出更多的組合應用,這也就是為什麼 Mapped Type 可以稱作是「型別魔法師」的重要地位了。
另外,上面提到的寫法也多可以透過泛型(Generic)抽成自己的 utility type 來做重複的應用。
未來有機會的話會在來分享 Mapped Type 搭配其他組合技做出的更多應用。

範例程式碼

最後附上這篇文章中有用到的 Code 供大家參考。

參考資料

2021年7月4日

透過工具建立有規範的 git commit message 吧

過去曾經整理過如何透過 semantic-release 這套工具整合 CI/CD 來達到自動化更新套件版號、產生 CHANGELOG 檔,並發佈到 npm 的流程。
當時雖然有提到 conventional commit 這個撰寫 commit message 的規範(convention),但還沒有實際透過一些好用的工具來建立 commit message 和針對 commit message 進行檢查。
在這篇文章中就來介紹幾套用來建立符合 conventional commit 的好用工具:
  • 透過 commitlint 進行 commit message 的檢查(lint)
  • 搭配 husky 在建立 commit message 前就自動執行 commitlint
  • 透過 commitizen 方便開發者建立符合 conventional commit 的 commit message
  • 使用 conventional-changelog 根據 commit message 來產生 CHANGELOG 檔
  • 使用 standard version 來同時更新版本號和產生 CHANGELOG 檔
如果是對於 CI/CD 中如何自動更新版號的部分,則可以參考過去寫的系列文章:發佈 npm 套件 - 從手動到自動

commitlint:檢查 commit message

commitlint 這套工具是用來作為 git commit 的 linter,並且可以搭配不同的 convention。
這裡選擇 config-conventional,也就是需要依據 conventional commit 的規範來寫 commit message:
  • @commitlint/cli 是用來執行 commitlint 的工具
  • @commitlint/config-conventional 是根據 conventional commit 所建立的規範

初次安裝

# 安裝 commitlint-cli 和 config-conventional
npm install --save-dev @commitlint/{config-conventional,cli}

# 會在專案中建立 commitlint.config.js 並放入設定
echo "module.exports = {extends: ['@commitlint/config-conventional']}" > commitlint.config.js

使用

# 使用 commitlint
$ echo "add commitlint" | npx commitlint
> ✖   subject may not be empty [subject-empty]
>type may not be empty [type-empty]
如果這個 commit message 不符合規範的話,會跳出錯誤:
commitlint

搭配 husky

但和 eslint 類似,如果不能在建立 git commit message 時就自動檢查規則的話,這個工具就會變得有點冗,這時候可以搭配 husky 這套工具。
# 第一次安裝 husky 才需要執行
$ npx husky-init && npm install

# 建立 commitlint 用的 git hook
npx husky add .husky/commit-msg 'npx --no-install commitlint --edit $1'
husky 這套工具可以讓開發者在不同的 git hook 執行不同的動作,例如在建立 commit 前(pre-commit)執行 ESLint 的檢查,如果檢查沒過就不能建立該次 commit。
這裡則是利用 husky 在 commit-msg 這個 git hook 去檢查 commit message 有沒有符合 conventional commit 的規範。這時打開專案中的 .husky/commit-msg,應該會長這樣:
#!/bin/sh
. "$(dirname "$0")/_/husky.sh"

npx --no-install commitlint --edit $1
預設執行 npx husky-init && npm install 的指令後,husky 會自動在 .husky 資料夾中建立 pre-commit 的檔案,它會告訴 husky 在建立 git commit 前去執行 npm test 的指令。但如果是 create-react-app 的專案,因為預設 npm test 會執行的是 watch mode,因此需要改成 npm test -- --watchAll=false
這時候在建立 commit message 是就會自動使用 commitlint 進行檢查,如果不符合規範的話,就無法成功建立 commit:
commitlint with husky

commitizen:建立 commit message

除了可以用 commitlint 搭配 husky 來檢查 commit message 之外,再來很重要的就是要能夠簡單方便的建立符合 conventional commit 的 message。因此就有幫助開發者建立 conventional commit message 的好用工具。
其中 commitizen 是同事 Ken 推薦非常多人使用的工具,它用起來的體驗蠻不錯的。另一套則是 commitlint 本身提供的 @commitlint/prompt-cli

commitizen(較推)

commitizen 是非常多人使用的的工具,相較於 @commitlint/prompt-cli 用起來感覺更友善一些:
# 安裝
npx commitizen init cz-conventional-changelog --save-dev --save-exact

# 之後要建立 commit 的話,只需要執行
npx cz
commitizen

@commitlint/prompt-cli

除了可以使用 commitizen 外,也可以使用 @commitlint/prompt-cli 來輔助我們建立 git commit message,但基本上挑一套使用就可以了。
# 初次安裝
npm install --save-dev @commitlint/prompt-cli
安裝完後執行:
# 建立 commit message
npx commit
就會跳出對應的 CLI 工具來協助建立 git commit:
@commitlint/prompt-cli

conventional-changelog:建立 CHANGELOG

在根據 conventional commit 來寫 commit message 後,我們還可以自動產生對應的 CHANGELOG 檔。這裡則會使用 conventional-changelog-cli
只需要執行:
  • -p angular:如果有使用 conventional commit 來建立 commit message 的話,就可以加上此選項。它會用符合 conventional message 的內容來產生 CHANGELOG;如果沒加此參數的話,所有 git message 都會進到 changelog 中。
# 第一次安裝
$ npm install --save-dev conventional-changelog-cli

# 檢視可以使用的 options 和說明
$ npx conventional-changelog --help

# 第一次產生 CHANGELOG
npx conventional-changelog -p angular -i CHANGELOG.md -s -r 0

# 將新的更新 message 添加到 CHANGELOG
npx conventional-changelog -p angular -i CHANGELOG.md -s
也可以把產生 CHANGELOG 的指令放到 package.jsonscripts 中:
diff --git a/package.json b/package.json
index 18f0899..37a1d41 100644
--- a/package.json
+++ b/package.json
@@ -21,6 +21,7 @@
  "scripts": {
     "build": "react-scripts build",
     "test": "react-scripts test",
     "eject": "react-scripts eject",
+    "changelog": "conventional-changelog -i CHANGELOG.md -s,
     "lint:staged": "lint-staged",
     "prepare": "husky install"
   },
@@ -51,6 +52,7 @@
  "devDependencies": {
     "@commitlint/cli": "^12.1.4",
     "@commitlint/config-conventional": "^12.1.4",
+    "conventional-changelog-cli": "^2.1.1",
     "cz-conventional-changelog": "^3.3.0",
     "husky": "^7.0.0",
     "lint-staged": "^11.0.0"
之後就只需要執行 npm run changelog 就會產生最新的 CHANGELOG 檔。

standard version:更新套件版本號

最後這套 standard version 是在針對套件進行版號更新,並同時產生該次更新的 CHANGELOG 檔,也就是說不需要再額外使用上述 conventional-changelog 的工具。
如果你產生 CHANGELOG 的時間都是在更新版本號時,且是使用 conventional commit 在建立 commit message 的話,則可以用 standard version 就好,不用再使用 conventional-changelog。
它會:
  1. 根據 conventional commit 的內容,依據 semver 的原則來更新版號
  2. 產生對應的 CHANGELOG
# 檢視所有可用的指令
npx standard-version --help

# 第一次 release
npx standard-version --first-release

# 更新套件版號和 CHANGELOG
npx standard-version

# 透過 dry-run 先看看會有什麼改變
npx standard-version --dry-run

# 更新到指定的版本
npx standard-version --release-as minor # 指定更新 minor 的版號
npx standard-version --release-as 1.1.0 # 指定更新後的版號
需要特別留意的是,當版號還在 v0.y.z,major 還沒進到 v1 是,會被視為是 pre-production 的產品,因此 feature 和 fix 都只會更新 patch version;breaking change 則只會更新 minor version。可以參考這個 issue 的討論:Version bumping isn't working properly based on Commit types
另外有需要的話,也可以把這個工具加到 package.json 中的 scripts 中:
diff --git a/package.json b/package.json
index d18c992..9832508 100644
--- a/package.json
+++ b/package.json
@@ -22,6 +22,7 @@
     "test": "react-scripts test",
     "eject": "react-scripts eject",
     "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
+    "release": "standard-version",
     "lint:staged": "lint-staged",
     "prepare": "husky install"
   },
執行的話變成:
# 更新版本
npm run release

# 執行 dry-run 看實際執行的話會有什麼改變
npm run release -- --dry-run

說明影片

2021年5月4日

從找衣服了解時間複雜度(Time Complexity)

剛剛用日常上班前挑衣服的例子和沒學過程式的 00 說明時間複雜度的概念很好理解耶~!
例子是這樣的...
一早要出門的時候,想要從衣櫃中找出紅色的上衣。
其中一種方式是像左圖一樣,這是掏寶上很熱門的「疊衣服褲子收納神器」,雖然看起來整理的很乾淨,但如果你要從中找到紅色的衣服,你就得要由上而下一件一件找,最糟的情況就是一直翻到最下面才能找到你要的紅色衣服。
另一種方式是像右圖一樣,把衣服用立起來的方式,一眼就可以看到紅色的衣服在哪,直接拿出來,幾乎不用找。
左圖的那種方式,時間複雜的就是 O(n),n 就是衣服的件數,雖然紅色的衣服有可能就放在最上面,一眼就可以看到,但在探討時間複雜度的時候都要考慮最差的情況,所以如果你有 n 件衣服,最差的情況就是要把 n 件衣服都翻過才會找到紅色那件。
右圖的方式它的時間複雜度是 O(1),在你沒有忘記其實衣服已經被丟到洗衣籃的前提下,你看一眼,翻都不用翻就可以把紅衣服直接取出(請先忽略掉人腦內建的視覺搜尋系統,那是另一個有趣的故事 XD)。這種不用一個一個找,就直接取出的,時間複雜度就是 O(1)
有了這個時間複雜度的概念後,是不是覺得左邊的那個商品實用性沒這麼高啦~ XDD
但我還是附一下購物連結(誤)
真的是沒想到學演算法還可以用在購物吧!

圖片來源

2021年4月26日

[心得] 2021 求職面試心得分享

由於過去求職時在 ptt 上或許多個人網誌中獲得了許多幫助,因此這次也來分享自己面試的心得,希望對於求職的大家們能夠有些幫助。
這次求職過程中,在和幾位不同的 Team Lead 或是 CTO 面談的過程中,真的讓我感受到多數厲害的人總是自信而謙虛的,他們不會透過問題來讓你覺得自己不懂,反倒是很 open-minded 讓你感受到雖然這個自己現在不懂,但沒關係,甚至會進一步透過提問來協助你進一步釐清自己的思路。
同樣地,我也期許對於自己的專業能夠是「自信而謙虛」的態度。
過去雖然常聽大神說,工作一陣子後,通常就不用自己找工作,而是靠別人介紹或挖角,但我可能還沒到這個階段,周圍沒什麼人介紹,更別說是挖角,所以還是只能靠自己 XDD。
下面是我這次有面試的幾間公司,主要找公司市場不侷限於台灣的公司,面試的職缺全部都是前端工程師。

Line Pay

首先 Line Pay 和 Line Taiwan、Line Bank 雖然都隸屬於 Line 集團底下,但在台灣是三間不同的公司。Line Pay 的面試過程較嚴謹,這次從投遞履歷到最終回覆的時間約需要一個多月的時間。
Line Pay 公司的地點是在大直美福大飯店的側邊,給人非常氣派豪華的感覺。

第零關:線上測試

給予連結,並透過線上測試的方式,題目主要是演算法的測驗,印象中是三題。

第一關:onsite-interview with Taiwan Engineer

面試的對象是 Taiwan Line Pay 的工程師們,會針對線上測試的作答進行討論,接著會根據過去實作過的專案進行問答,並可利用白板進行概念的解釋與說明。

第二關:onsite-interview with Korean Engineer

這關給我的經驗很特別,因為是透過視訊的方式和韓國的工程師們進行面試,原本以為會需要用英文會話,但面談現場直接就有一位中韓文的即時口譯,所以並不需要說到英文,和面試官的溝通會完全透過這位翻譯。(心裡 OS:大公司就是直接找翻譯這樣的氣派。)

第三關:onsite-interview with HR

最後會和 HR 進行面談,除了討論期待的薪資,也會針對個人或過去的工作經驗進行暸解。據 HR 表示,目前 Line 和 Line Bank 都搬到同一棟建築物,但 Line Pay 因為剛搬到美福大飯店這邊不久,因此暫時沒有再次搬遷的打算。
最後,HR 會與你進行基本的英文會話,確認有基本英文溝通能力。

KKStream

KKStream 則是隸屬於 KKBOX Group 的公司,做的是影音串流服務,可以想成是讓客戶能夠透過 KKStream 的服務建立 Netflix 或 MyVideo 這類影音平台。

第零關:線上測試

給予連結,並透過線上測試的方式,題目主要是演算法的測驗。

第一關:onsite-interview with Team Lead

完成線上測驗通過後,會有一份作業,作業內容是用 React 寫一個待有基本的 CRUD 以及搜尋功能的網站(可以簡單想成 TodoList 這類),作業需在此次面試前完成,並提交到 Github 私人的 repo。
KKStream 前端目前分成三個組別-Core Tech、BlendVision 和 Enterprise。各組各派一人前來面試,會針對作業內容進行討論,接著則根據過去開發過的專案進行討論。

第二關:onsite-interview with PM & Engineer Manager

第一關結束後,會根據各組人數的需求將面試者配到適合的組別,也就是一開始投的組別,不見得會是最後的組別,這個部分也可以再和 HR 或 Engineer Manager 進行了解。
PM 和 Engineer Manager 比較不是針對技術的部分進行發問,而是針對過去的經驗試著了解自己是個怎麼樣的人。在這次面試中和 Engineer Manager 聊了蠻久的時間,包括帶領 Team 的方式、對於前後端的想法、測試撰寫的想法等等,覺得有非常多的收穫。

第三關:online-interview

HR 會針對期待薪資進行了解,並試著了解自己過去的經歷。另外,會與一位主管進行面談,過程比較像是在聊天,互相分享彼此的經驗和價值觀。

OneDegree

OneDegree 的前端工程師還有分不同 team,分別是做 2C 和 2B,這裡我是面試 2B 的團隊。OneDegree 主要是開發保險系統,讓保險公司能透過此保險系統建立保險商品,並供一般消費者能夠以網路進行線上投保。

第零關:線上測試

給予連結,並透過線上測試的方式,題目包含演算法、React 和 Git 的問答題。

第一關:onsite-interview with Team Lead

主要是與 Frontend Team Lead 們進行面試,一開始會先請面試者以英文自我介紹,並且透過英文進行簡短的問答,主要也是確認面試者有基本的英文能力。接著會切換回中文,同樣是根據過去做的專案進行討論,並且分享彼此對於不同技術上的想法。

第二關:onsite-interview with Taiwan Director & HR

再來會與 OneDegree 台灣區的總監和 HR 進行面談,這次面談比較不會談到技術上的問題,比較像是互相了解彼此的聊天。

總結

OneDegree 的回應速度還蠻快的,對於面試者來說不會有太長時間的等待。

Privé Technologies

Privé Technologies 的 recruiter 主動聯繫,Privé Technologies 是一間立基於香港的 Fintech,工程師遍佈在世界不同的地方,目前工程師主力是在香港和台灣。

第零關:線上測試

給予連結,並透過線上測試的方式,題目主要是前端 JavaScript / React 的測試。

第一關:online-interview with Frontend Team Lead

透過 Online 的方式與位在香港的 Frontend Team Lead 進行面談,過程全程使用英語。主要是針對過去的專案進行提問,也有詢問到對撰寫測試的想法,並討論「怎麼樣算是好的程式碼」?

第二關:online-interview with Frontend Engineer

一樣是透過 online 的方式進行面談,面試官是在台灣的前端工程師(很巧的是過去和他還有短期合作過相同的專案)。一開始一樣會以英文進行自我介紹和簡短的問答,確認面試者有足夠的英文會話能力。接著會切換回中文,討論「怎麼樣算是好的程式碼」、還有聊到 OOP 和 Functional Programming 適合的時機、另外則是 JavaScript 有關的題目。
另外,也有進行 online 的 coding test,內容偏向基本的演算法和邏輯實作。

第三關:online-interview with CTO

印象沒錯的話 CTO 是澳洲人,但在香港待了蠻久的一段時間,目前和 Frontend Team Lead 一樣都在香港,他也曾在 LaLaMove 擔任過 CTO 的職位。
面試全程以英文進行,一樣會討論到「怎麼樣算是好的程式碼」,另外則是聊一些個人的經歷、和同事的相處、人格特質等等的。

總結

Privé Technologies 是回覆相當快速的公司,收到回覆後會立即安排下一場的時間,不論是 HR、Team Lead 到 CTO 都給人很和善親切的態度,可以讓人感受到是相當尊重且重視面試者的。

慧科訊業 Wisers

慧科是由 Headhunter 推薦,公司主要是做輿情分析的,會去爬各媒體或社群的資料、關鍵字,以此分析當前熱門的議題或輿論風向,市場主要是在中國。

第一關:online-interview

第一關會先以線上的方式進行面談,面試官來自台灣、香港和中國。這裡我有一點小烏龍的是,收到通知的時候,看到 email 寫的是「phone interview」,誤以為是面試官會打電話來...,接著等了又等,想說時間到了怎麼都沒打電話來,後來才知道 phone interview 指的是視訊面談 XDD
面試主要問過去實作過哪些專案,有沒有處理過複雜的圖表或大量資料需要 render 的經驗,怎麼樣優化和除錯等等。

第二關:onsite-interview

雖然說是 onsite-interview,但除了和台灣的工程師面試之外,同時也會透過視訊和香港以及中國的主管面談。中國的 Frontend 主管問了很多技術相關的問題,從 CSSOM、Web Component、micro-frontend、performance、如何避免瀏覽器被阻塞(block)都有問到。

總結

可以感覺的出來 Frontend Team Lead 的知識深度很深,我也並沒有全部都回答得出來,但 Team Lead 人非常有耐心,就像個 mentor 一樣,會給我一些思路讓我再去思考這個問題有沒有其他的可能性或答案,面試完後真的有一點「如沐春風」的感覺不誇張 XD。

常見問題

如果需要準備英文面試的話,也很推薦 Coursera 上這堂免費的課程 English for Career Development,若時間不夠的話,也可以根據自己的需要,直接跳著進度看,不用從頭慢慢看。
從技術面來說,JavaScript 面試的內容除了可以參考很久以前整理過的「JavaScript: Understanding the Weird Part(JavaScript 全攻略:克服JS 的奇怪部分)」筆記之外,網路上也可以搜尋到非常非常多;React 的話,基本的官方文件一定要看過。
有些東西雖然每天都在用,但若沒準備一時被問到的話,還是可能會沒辦法很快速且順暢的解釋出來。例如,請你解釋 event loop 是什麼。
在上述的面試中,撇除技術問題外,有一些共同常被問的,像是:
  • 自我介紹
  • 為什麼離開前一份工作
  • 上一份工作中覺得最困難或最具挑戰的是什麼?
  • 想像未來三年後你預期自己會是個什麼樣的人?
  • 有什麼問題要問我的嗎?
另外,也可以參考這部 3 分鐘的影片,裡面許多題目大家一定都聽過,但還是可以稍微想一下怎麼回答:

2021年4月20日

[心得] ALPHA Camp X 天下雜誌:那些年我們一起走過的數位轉型

ALPHACamp X 天下雜誌:那些年我們一起走過的數位轉型
這次很幸運有機會能夠擔任 ALPHA Camp 與天下雜誌合作舉辦的實體/線上活動,也是我自己第一次擔任活動主持人。
從小,我家就非常多與天下相關的雜誌,不論是天下、康健、Cheers 都有,因為我爸媽算是很早期的訂戶,所以一開始收到 ALPHA Camp 詢問能否的擔任活動主持人時,我內心是有些興奮的,是一種竟然可以有機會進到從小就一直在接觸的媒體的雀躍感,而且天下雜誌多數時候也給我相當正面的感受,算是台灣媒體界的清流之一。
除了天下雜誌相當知名的媒體之外,我也很好奇工程師在當今的媒體產業中究竟扮演了什麼角色。主力是在開發「內容管理系統」?或多在進行資料視覺化的專案?
在這次的活動中很幸運能夠聽到已經在天下雜誌 10 多年的資深產品經理-紹謙,和數位轉型過程中加入團隊,負責從專案發想到實際落地的資深工程經理-世彥,一起來聽他們分享天下雜誌的數位轉型。
ALPHACamp X 天下雜誌:那些年我們一起走過的數位轉型

數位轉型是什麼?

在聽演講前,其實我完全不知道「數位轉型」究竟是怎麼一回事,我單純地以為就是把紙本書變成電子書,或是推出幾個 App 後,就算是完成了數位轉型?

數位轉型不是事件的完成,而是持續且沒有終點的歷程

然而,在聽完兩位講者的分享後,我深切感受到數位轉型絕對不是「做完了 OO」就叫完成了數位轉型這麼簡單,並非把紙本雜誌電子化、推出幾個手機 App、開發幾個 Web 專案就叫完成了數位轉型。數位轉型的過程相當複雜,牽涉到的不只是使用到的技術、文章撰寫的工具、還包括整個組織架構的調整。
最早天下雜誌完全是紙本作業、編輯是以寫稿紙作業。過去上稿流程是先有紙本文章然後把文章變成電子檔後放在網路上,現在則轉變成線上文章先推出後,才有實際紙本內容;過去團隊中大部分都是編輯,現在則多了產品經理、軟體工程師、數據分析師等各種角色加入團隊;過去沒辦法從使用者的操作中取得大量的資料,現在則可以透過使用者使用 App 或閱讀文章等資料作為反饋,來協助指導後續的決策和產品修正。

數位轉型是不怕面對改變,敢於挑戰不熟悉的事物

如果要我說數位轉型是什麼?我認爲就是不怕潮流的變化,努力學習讓自己能夠跟上最新的事物,不怕面對自己不熟悉的事物,願意不斷嘗試與接受挑戰。這就好像一個永遠不會老的人,不斷地透過新陳代謝讓自己的身體和腦袋維持在年輕的狀態。
天下雜誌並沒有在完成了雜誌電子化,推出手機 App、建立網路內容平台後,就因為覺得「完成了數位轉型」而停下來。在近年 Youtube 的普遍和 Podcast 的竄起,天下雜誌也都沒有缺席,推出了 Youtube 頻道和 Podcast 節目,繼續跟著數位的潮流前進。因為數位轉型是一種不怕面對改變,敢於挑戰不熟悉事物的精神,因此它是沒有什麼叫做「已經完成的」

有價值的工程師

在這場活動中,兩位講者也分享到他們認為什麼樣的工程師是有價值的。

先釐清問題,再提出更多可能的解決方式

其中一點是當 PM 提出一個需求(或功能)時,好的工程師會試著向 PM 去了解這個需求(或功能)是想要解決什麼問題,先把實際想要解決的問題釐清,接著再和 PM 討論如果是想要解決這個問題的話,有哪些可行的做法,因為 PM 一開始提的功能或許只是其中一種解決方式,但工程師在釐清問題後,會多了工程面可行性的評估,進而有機會提出不同的解決方式供 PM 參考與選擇。

對於開發的產品有 Ownership

另外一個特質則是對產品有強烈的 Ownership,工程師不單純只是把 PM 所交付的功能完成,同時他也喜歡自己完成的產品、會好奇使用者使用時的體驗、會去思考怎麼樣能把這個產品做得更好。

不怕面對改變,勇於嘗試新事物、敢於挑戰自己的態度

作為軟體工程師,總是有新的技術、沒用過的工具、沒聽過的詞彙,但許多時候我也會怠惰,覺得學新的好累、現有的東西就夠用了吧?聽完這場活動後,我最大的反思在於,我想有價值的工程師絕對不止是學會了某些技術或工具後,就成為了一個優秀的工程師,反倒是一種態度或精神-一種不怕面對改變,勇於嘗試新事物的精神;一種不怕碰到沒解過的問題,敢於挑戰自己的態度,而這點也正好呼應了這場活動談到的「數位轉型」。

總結

很開心初次主持活動就能和天下雜誌合作,而且又能夠聽到兩位非常有經驗的產品經理與工程經理進行分享。
ALPHACamp X 天下雜誌:那些年我們一起走過的數位轉型
ALPHACamp X 天下雜誌:那些年我們一起走過的數位轉型

2021年3月26日

gRPC 是什麼?以 Golang 進行示範與說明

gRPC 說明影片 @ BESG

:::tip source code
對應的程式碼可檢視 besg-grpc 的 repository。
:::

gRPC 是什麼:以 Golang 說明與實作

RPC 的全名是 remote procedure call,主要是作為電腦和電腦間溝通使用。A 電腦可以呼叫 B 電腦執行某些程式,B 電腦會將結果回傳給 A 電腦,A 電腦在收到回應後會再繼續處理其他任務。RPC 的好處在於,雖然 A 電腦是發送請求去請 B 電腦做事,但其呼叫的方式,就很像是 A 電腦直接在呼叫自己內部的函式一般。
gRPC 也是基於這樣的概念,讓想要呼叫 server 處理請求的 client,在使用這支 API 時就好像是呼叫自己內部的函式一樣簡單自然。從功能面來說,gRPC 就像 Web 常用的 Restful API 一樣,都是在處理請求和回應,並且進行資料交換,但 gRPC 還多了其他的功能和特色。
gRPC 是由 Google 開發的開源框架,它快速有效、奠基在 HTTP/2 上提供低延遲(low latency),支援串流,更容易做到權限驗證(authentication)。在下面的文章中,將會對於 gRPC 能提供的特色有更多說明。

Protocol Buffers 是什麼

在學習 gRPC 時,需要同時了解什麼是 Protocol Buffers。在傳統的 Restful API 中,最常使用的資料交換格式通常是 JSON;但到了 gRPC 中,資料交換的格式則是使用名為 Protocol Buffers 的規範/語言。
Protocol Buffers vs JSON
也就是說,當我們想要使用 gRPC 的服務來交換資料前,必須先把資料「格式」和「方法」都定義清楚。
:::tip
使用 gRPC 前,不只需要先把資料交換的格式定義清楚,同時也需要把資料交換的方法定義清楚。
:::
這裡要稍微釐清一點很重要的是,Protocol Buffers 可以獨立使用,不一定要搭配 gRPC;但使用 gRPC 一定要搭配 Protocol Buffers

實作將 Protocol Buffers 編譯成在 Golang 中可使用的檔案

對應的程式碼可檢視 besg-grpc repository 中的 proto 資料夾。

STEP 1:撰寫 Protocol Buffers 檔案

  • 使用 message 定義資料交換的格式
  • 使用 service 定義呼叫 API 的方法名稱
syntax = "proto3";  // 定義要使用的 protocol buffer 版本

package calculator;  // for name space
option go_package = "proto/calculator";  // generated code 的 full Go import path

message CalculatorRequest {
  int64 a = 1;
  int64 b = 2;
}

message CalculatorResponse {
  int64 result = 1;
}

service CalculatorService {
  rpc Sum(CalculatorRequest) returns (CalculatorResponse) {};
}

STEP 2:安裝編譯 Protocol Buffer 所需的套件

此部份可參考 編譯 Protocol Buffers(Compiling) 段落。

安裝 compiler

# 安裝 compiler,安裝完後就會有 protoc CLI 工具
$ brew install protobuf
$ protoc --version  # Ensure compiler version is 3+

# 安裝 protoc-gen-go 後可以將 proto buffer 編譯成 Golang 可使用的檔案
$ go get github.com/golang/protobuf/protoc-gen-go

# 安裝 grpc-go 後,可以在 Golang 中使用 gRPC
$ go get -u google.golang.org/grpc

STEP 3:編譯 Protocol Buffer 檔案

進到放有 .proto 檔的資料夾後,在終端機輸入下述指令:
$ protoc *.proto --go_out=plugins=grpc:. --go_opt=paths=source_relative
在成功編譯好後,應該會看到同樣的資料夾位置出現 *.pb.go 的檔案,這就是編譯好後可以在 Golang 中使用 Protocol Buffer 和 gRPC 的檔案。

實作 gRPC Server

對應的程式碼可檢視 besg-grpc repository 中的 server 資料夾。

STEP 1:建立 gRPC server

type Server struct {}

func main() {
 fmt.Println("starting gRPC server...")

 lis, err := net.Listen("tcp", "localhost:50051")
 if err != nil {
  log.Fatalf("failed to listen: %v \n", err)
 }

 grpcServer := grpc.NewServer()
 calculatorPB.RegisterCalculatorServiceServer(grpcServer, &Server{})

 if err := grpcServer.Serve(lis); err != nil {
  log.Fatalf("failed to serve: %v \n", err)
 }
}

STEP 2:實作 Protocol Buffer 中的 service

func (*Server) Sum(ctx context.Context, req *calculatorPB.CalculatorRequest) (*calculatorPB.CalculatorResponse, error) {
 fmt.Printf("Sum function is invoked with %v \n", req)

 a := req.GetA()
 b := req.GetB()

 res := &calculatorPB.CalculatorResponse{
  Result: a + b,
 }

 return res, nil
}

STEP 3:啟動 server

在終端機中輸入:
$ go run server/server.go
即可啟動 gRPC server。

補充:使用 Bloom RPC 進行測試

在只有 server 的情況下,可以使用BloomRPC 這套工具來模擬 Client 對 gRPC server 發送請求,功能就類似在 Restful 中使用的 Postman。
使用時只需要匯入 proto 檔後,即可看到對應可呼叫的方法和可帶入的參數,能這麼方便也是因為在 protocol buffer 中已經把傳輸的資料格式和能對應呼叫的方法都定好的緣故。
Bloom RPC

建立 gRPC Client

完整程式碼可檢視 besg-grpc repository 中的 client 資料夾。

STEP 1:與 gRPC server 建立連線

func main() {
 conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure())
 if err != nil {
  log.Fatalf("failed to dial: %v", err)
 }

 defer conn.Close()

 client := calculatorPB.NewCalculatorServiceClient(conn)

 doUnary(client)
}

STEP 2:使用 Protocol Buffers 中定義好的 Service

func doUnary(client calculatorPB.CalculatorServiceClient) {
 fmt.Println("Staring to do a Unary RPC")
 req := &calculatorPB.CalculatorRequest{
  A: 3,
  B: 10,
 }

 res, err := client.Sum(context.Background(), req)
 if err != nil {
  log.Fatalf("error while calling CalculatorService: %v \n", err)
 }

 log.Printf("Response from CalculatorService: %v", res.Result)
}

STEP 3:向 server 發送請求

在終端機中輸入:
$ go run client/client.go
即可執行 client.go 並向剛剛起動好的 server 發送請求。

gRPC 解決了什麼

gRPC 和 REST API 的比較

簡單來說,gRPC 在效能上比起 REST API 好非常多:
項目 gRPC Restful API
資料傳輸格式(Payload) Protocol Buffer - 更快且更小 JSON, XML, formData - 較慢且較大
通訊協定 HTTP/2 HTTP
傳輸方式 支援一般的「請求-回應」、伺服器端串流、Client 端串流、與雙向串流(streaming) 僅能透過 Client 發送請求、Server 給予回應
API 方法命名 沒有限制,一般會直接描述該方法要做的事,例如 createUser, getUser。不需要思考路由命名。 使用動詞(GET, POST, PUT, PATCH, DELETE)搭配資源來命名。需要根據不同的行為來定義不同的路由。
Client 呼叫 API 的方式 就像呼叫一般的函式 透過特定的 Endpoint,給予符合的資料型別
Server 建立 API 的方式 根據文件(Protocol Buffer)實作功能,不需要額外檢查資料型別與方法正確性。 根據文件(Swagger)實作功能,但須額外檢查資料型別。
根據文件產生程式碼 gRPC OpenAPI / Swagger
此外,gRPC 的 server,預設就是非同步的,因此不會阻塞任何進來的請求,並可以平行處理多個請求。gRPC Client 則可以選擇要用同步(阻塞)或非同步的方式處理。

使用 Protocol Buffers 的好處

  • 節省網路傳輸量:速度更快、檔案更小
  • 節省 CPU 消耗:Parse JSON 本身是 CPU intensive 的任務;Parse Protocol Buffer(binary format)因為更接近底層機器表徵資料的方式,消耗的 CPU 資源較低
  • 跨程式語言:Protocol Buffer 可以根據不同的程式語言編譯出不同的檔案
  • 可以寫註解、型別清楚明確
:::tip
節省網路傳輸量和 CPU 消耗在行動裝置上的影響可能更重要。
:::

跨程式語言的好處

透過 Protocol Buffer 定義好資料的傳輸欄位(message)和呼叫的方法(service)後,gRPC 即可在不同程式語言上運行,這非常適合微服務(micro-services)的應用情境,只要雙方一起定義好 schema 後,就可以用不同的程式語言進行開發。

使用 HTTP/2 的好處

傳統的 HTTP/1.1 在每個 TCP 連線中只允許向 server 發送單一個請求,但當網頁載入時,往往會需要向同一個伺服器發送多個請求(例如、圖檔、CSS、靜態檔、JS 等),因此為了要避開這樣的限制、加快載入的速度,瀏覽器會實作多個平行的(parallel) TPC 連線(每個瀏覽器實作不同,因此數量的上限也不同),以處理同時向伺服器發出的多個請求。
在 HTTP/2 中則可在同一個 TCP 連線中進行多個請求和回應,並且可以由 server 主動推送資源給 client,而並非一定要透過 client 主動請求;此外支援 HTTP Header 的壓縮,減少資料傳數量;HTTP/2 也是使用 binary 的方式在傳輸資料。
HTTP2

gRPC 的四種類型

  • Unary:類似傳統 API,client 發送 request 而 server 回傳 response
  • Server Streaming:透過 HTTP/2,client 發送一次 request,而 server 可以回傳多次資料
  • Client Streaming:client 發送多次資料,直到告知 server 資料傳完後,server 再給予 response
  • Bi Directional Streaming:兩邊都用串流的方式傳送資料
gRPC
service GreetService {
  // Unary
  rpc Greet(GreetRequest) returns (GreetResponse) {};

  // Streaming Server
  rpc GreetManyTimes(GreetManyTimesRequest) returns (stream GreetManyTimesResponse) {};

  // Streaming Client
  rpc LongGreet(stream LongGreetRequest) returns (LongGreetResponse) {};

  // Bi-directional Streaming
  rpc GreetEveryone(stream GreetEveryoneRequest) returns (stream GreetEveryoneResponse) {};
}

gRPC 的缺點

  • Protocol Buffer 不像 JSON 是 Human Readable。
  • 需要額外的學習時間和導入成本。
  • 瀏覽器原生目前還不支援,須透過套件 grpc-web 來處理。

其他

推薦工具

  • BloomRPC:方便用來模擬 Client 對 gRPC server 發送請求,功能就類似在 Restful 中使用的 Postman。

錯誤排除

protoc-gen-go: program not found or is not executable

# 需要把 $GOPATH/bin 加到 .zshrc/.bashrc 等
$ echo 'export PATH=$PATH:$GOPATH/bin' >> $HOME/.zshrc

參考資料