GitHub是版本管控程式碼好用的空間，也能做Git版本管控的簡單練習。
只要是撰寫程式，參考別人的程式碼，很多程式碼都放在GitHub上面，但不是所有，也是有別的空間可以放。
Android能做版本管控的方法，不一定要使用GitHub。
不過本網站之後會以GitHub為主要版本管控的空間，因此在此介紹GitHub。
本篇重點不是Git教學，是將Code放置GitHub
之後會寫幾篇與Git相關的文章
首先到Amazon官網下載，網址如下
https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html
下載好後安裝，按照預設的安裝即可
請至官網下，網址如下
https://www.jetbrains.com/idea/download/#section=windows
這樣Intellij IDEA 環境就設定好，可以開始使用囉
Cocoapods是能夠提供第三方Library的工具
使用他有一定的規則，依照此規則就能導入，所需的Library
打開終端機->輸入以下
sudo gem install cocoapods
設定pod
pod setup –verbose
成功會顯示 Setup completed
輸入pod –version
有返回版本號代表設置完成
到此就安裝完囉
.xcwordkspace是CocoaPods的使用時會生成的，要用此開啟專案，才會使用CocoaPods
生成.xcwordkspace方法如下
打開終端機，cd到專案路徑
之後輸入pod init
資料夾內就會出現Podfile
用XCode或文字編輯器打開它
platform :ios, ‘9.0’ 前面#拿掉，代表允許最小版本
use_frameworks!下面輸入
//使用預設版本 pod 'LabelSwitch' //如果需要指定版本 pod 'LabelSwitch', '~> 0.1.6'
代表需要安裝'LabelSwitch'
然後儲存此文件檔案
終端機輸入pod install
就安裝完囉
之後專案由.xcwordkspace打開
寫程式時，常常會發生同樣的東西要輸入好幾次，在設定語法快捷鍵後，相同的程式碼，可以改成快捷鍵，這樣在撰寫程式時，可以省下不少時間
如果能讓程式碼分離關注點，會讓程式碼看起來更容易閱讀
這樣快速指令就設定完囉
要甚麼快捷鍵，都可以依這方法操作
在XCode裡面，如果輸入
//MARK: -時，如下
因此可以利用extension 做程式碼的擴展
將繼承的Delegate各別寫成一個擴展
class ViewController: UIViewController {
}
//MARK: - ManagerDelegate
extension ViewController: ManagerDelegate {
}如上程式碼，將ManagerDelegate 寫成一個擴展，所有有關ManagerDelegate 的都寫在此
UIViewController 做為主架構，不在多繼承其他Delegate
達到關注點分離，讓程式碼更容易閱讀
寫程式時，常常會發生同樣的東西要輸入好幾次，在設定語法快捷鍵後，相同的程式碼，可以改成快捷鍵，這樣在撰寫程式時，可以省下不少時間
File -> Setting -> Editor -> Live Templates
如果是Kotlin設定在AndroidKotlin裡面
如果是Java設定在Java裡面即可
本文以Kotlin為主
所以設定在Android Kotlin裡面
假設我要的固定格式如下
/**
* @param 引數資訊
* @return 返回資訊
* @throws 丟擲異常資訊
* @see 有的函式需要藉助其他類或者函式或者屬性,就用該標籤標識
* @Description 函式不建議使用,原因是
* @since 自哪個版本開始
* @author John
*/
還有一個快速引入參數的用法，如下
private const val KEY_$value$ = "$value$"使用時，$value$是可以手動輸入的，當$value$輸入時，前後都會一起改變
如下圖
$value$可以自己設定，任何名字都可以
相同的名字輸入時，就會同時改變
這樣快速指令就設定完囉
Sourcetree是一個提供版本管控GUI介面，包含Git
提供Windows與MacOS兩個版本
Sourcetree網站下載:
https://www.sourcetreeapp.com/
本文章以Windows來介紹，他與GitHub之間如何使用
需準備GitHub帳號
GitHub網站:
無法Push的問題，參考:
Sourcetree GitHub不接受帳戶密碼驗證解決方法
Repository name是這個Git的名稱
Description是描述專案內容
public是指公開的意思
Private是指私有的意思，使用必須登入帳號
Add a README file新增一個說明文件
Add .gitgnore新增一個過濾文件
Choose a license如果有用到License可以在此新增
都好了以後，按下Create repository
有兩個方法
備註:此方法無法使用Private專案，會要求Login，密碼為Token
申請Token的方法，參考:
Sourcetree GitHub不接受帳戶密碼驗證解決方法
左側的BRANCHES是指本地的分支名稱
左側的REMOTES是指遠端的代表名字
中間的main代表本地這個版本main持有
中間的origin/main代表遠端這個版本origin/main持有
origin/HEAD代表遠端起始HEAD，一般不會去動他，保持遠端有最初始的版本
中間main左邊的空心球，代表本地的HEAD，指本地當前使用的版本
可以使用滑鼠右鍵Checkout…或雙擊兩下切換本地HEAD
中間的Inital commit是此版本的描述
下方的+ .gitgnore代表此版本新增了這個檔案
滑鼠右鍵，可以針對這個版本做一些動作
Tag…代表為此新增標記
Archive…代表備份當前選擇的
Branch…代表新增分支
new Branch代表新分支名稱
Checkout New Branch代表新增後以他為準做控制
有資料夾內有檔案變化時
Staged files代表準備要Commit的檔案，可以點右邊的-號，就會自動跑至Staged files
Unstaged files代表尚未加入要Commit的檔案，可以點右邊的+號，就會自動跑至Staged files
對檔案右鍵->Remove會從資料夾中被刪除
對檔案右鍵->Discard會從資料夾中被還原成未修改前的檔案(檔案本身就存在，但內容被修改時)
打勾下方的Push代表，Commit後會把當前檔案Push至遠端，並新增新的版本
不勾只會本地新增新的版本，遠端依然是舊的
當Staged files有檔案後，可以按左上角Commit，會轉到此畫面
這樣本地和遠端都成功同步版本囉
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
本文章以此方法來解決
GitHub官網:
手機App下載 Google Authenticator，然後用此App掃描QRCode
之後會在此生成一組限時的密碼，將此輸入
接下來又符合雙重認證的條件了
到此GitHub前置作業就完成囉
有兩種方式可以使用
Clone的時候格式如下
https://<token>@<git_url>.git例如
網址為https://xxxx.git
toekn為ghp_ZGGGGqXi2nyRRRRRRRRw0qw1KKKK
clone時
https://ghp_ZGGGGqXi2nyRRRRRRRRw0qw1KKKK@xxxx.git此方法有一個缺陷，必須要提供給別人token才能夠正常Push檔案
曾經已經安裝過sourcetree，且已經有Login過帳號的人
就算移除Sourcetree重新安裝，依然會有問題，解決方案如下
先關閉Sourcetree
至C:\Users\<使用者帳號>\AppData\Local\Atlassian\SourceTree
刪除passwd檔案
重新打開Sourcetree，此時Push檔案時，會跳出下圖
Login後就可以正常使用囉
如果還是不行，刪除passwd檔案，重新Clone，再測一次
Visual Studio Code簡稱VSCode
是用來閱讀源碼的好工具，跨平台Windows、macOS、Linux都可以使用
以下介紹如何編譯MinGW、Clang、LLVM的環境設定
首先下載本體:
https://code.visualstudio.com/
再來下載編譯環境的工具(以下網址為Windows編譯工具):
接下來設定環境變數
設定好後，打開Windows PowerShell輸入
g++ –version
clang –version
此時會返回版本號，如果沒有注意環境變數與解壓縮的路徑是否一致
到此MinGW、Clang已經建立好環境了
下載Visual Studio 2022，下載社群版，免費的就好
https://visualstudio.microsoft.com/zh-hant/downloads/
安裝時，開發桌面C++要打勾
安裝後，打開Developer Command Prompt for VS 2022
輸入cl.exe
如果此指令可以使用，代表環境也建立好了
到此
MinGW、Clang LLVM、MSVC三個環境皆建立完成
打開VSCode，並且按下左邊第五個(Ctrl+Shift+X)
安裝Chinese (Traditional) Language Pack for Visual Studio Code VSCode工具就會變成繁體中文
繁體中文(可安裝可不安裝)
安裝C/C++ Extension Pack
到此環境就安裝好了
這裡會使用MinGW、Clang LLVM、MSVC這三個編譯C++
到此MinGW就可以運行囉
與MinGW設定方式一樣
此處比較不一樣
先把VSCode關掉
打開Developer PowerShell for VS 2022
切換到要編譯的資料夾
輸入: dir (檢查一下，是否是自己要的路徑)
確定後輸入: code .
(.要記得輸入)
此時他會"自動"運行VSCode，並且導入MSVC的環境變數
當執行public static void main(String[] args)時，報出以下錯誤訊息
SourceSet with name ‘main’ not found.
如下，新增下面那行即可編譯
<option name="delegatedBuild" value="false" />
jar僅能含java class不能含有資源
aar除了java class外，還可以包括資源在內
一個library如果要編譯成aar，不能implementation aar，否則會編譯失敗，但可以含有jar
//id 'com.android.application'註解 id 'com.android.library'改為這個 //applicationId 'com.xxx.xxx'這個也註解
task deleteJar(type: Delete) {
delete 'libs/commonTest.jar'
}
task createJar(type: Copy) {
from('build/intermediates/compile_library_classes_jar/release/')
into('libs/')
include('classes.jar')
rename('classes.jar', 'commonTest.jar')
}
createJar.dependsOn(deleteJar, build)
備註：這裡需要使用Tasks，如果找不到Tasks
參考這個文章Android Studio 右側Gradle Tasks選項消失？
備註：刪除jar一樣，找到deleteJar雙擊兩下執行，就可以囉
//id 'com.android.application'註解 id 'com.android.library'改為這個 //applicationId 'com.xxx.xxx'這個也註解
Codeilin的旅程 