最近萊德受友人所託，幫忙研究了一下 TyranoBuilder 這套視覺小說製作軟體，其輸出至手機平台的流程，在這邊分享給有需要的讀者！
TyranoBuilder Steam 商店頁面
https://store.steampowered.com/app/345370/TyranoBuilder_Visual_Novel_Studio/
經過我實際操作官網上的說明，發現 Android Studio 執行 TyranoBuilder 輸出的 Android 專案時會發生錯誤，這個部分也會在文中說明。
Exporting for Android Devices
http://tyranobuilder.com/exporting-for-android-devices/
我的系統/軟體環境如下：
macOS Catalina 10.15.2
Android Studio 3.5.1
一、【建置Android專案】
首先，先使用 Android Studio 新建一個專案，選擇 " Empty Activity "
如果你還沒有安裝 Android Studio ，可以前往官網下載最新版本：
https://developer.android.com/studio
設定你的專案 " Name " 與 " Package name " 之後，即可按下 " Finish " 建立專案。
（ Language 選擇 Java 即可）
專案建立完成之後， Android Studio 就先放著，等等會再回來操作。
二、【匯入TyranoBuilder專案內容】
從官網教學下載 Android 的 Sample 專案，解壓縮之後，裡面的結構會與下圖相同。
相信開發過 Android 專案的讀者一看到 " main " 就會很熟悉XD
" main " 裡面的 " assets " ，通常是放入一些外部資源，例如圖片、音樂等等的多媒體檔案，而目前只有 tyrano_player.js 這個檔案，代表我們應該會需要匯入 TyranoBuilder 專案的內容在這裡面。
接著，來到友人給我的專案資料夾，這個是 TyranoBuilder 輸出的 Android 專案，需要把裡面的內容全部複製起來。
然後到剛剛下載的 Sample 專案，在
main => assets
裡面貼上所有複製的內容。
接著，複製 Sample 專案的 " main " 資料夾。
來到方才 Android Studio 新建立的專案，
app => src => main
把 " main " 整個刪除。
緊接著，把剛剛在 Sample 專案複製的 " main " 資料夾貼上。
回到 Android Studio ，會自動同步檔案內容。
此時可以按下
Build => Make Project
跑跑看。
三、【Debug除錯】
在建置的過程中馬上會發生錯誤。
研究後發現，主要原因是新版的 Android Studio 已經棄用 support 的函式庫，此時要將 MainActivity 當中 import 出現紅字的 Library 刪除，不要 import 它們。
接著來到出現問題的 AlertDialog ，游標移到上面，按下鍵盤
" Alt/Option + Enter " => 選擇 import " android.app "
紅字錯誤即可解決。
或者在 MainActivity 上方手動鍵入 " import android.app.AlertDialog " ，也可以解決紅字錯誤。
修正程式碼之後，再次按下
Build => Make Project
此時就能順利建置專案囉！
四、【建立AVD】
想要查看實際運行的畫面，最簡單的方式就是建立一台 AVD ，也就是 Android 的虛擬機。
如圖所示，
" Open AVD Manager "
" Create Virtual Device... "
選擇機型
下載想要的 Android 系統版本，就可以建立一台 AVD 囉。
好不容易， AVD 已經 Ready 了，就讓我們運行看看吧！
按下工具列像播放鍵的綠色執行鈕 " Run app "
Android Studio 會自動開機你設定好的 AVD ，並運行你的 App 。
咦？畫面怎麼不是橫向的...XD
五、【設定螢幕方向】
原來是因為我們新建的專案還沒有指定這個 MainActivity 的螢幕方向（Orientation），而專案預設都會是垂直方向，當我們想要某個 Activity 的螢幕轉向固定為水平，需要打開
app => manifests
在 AndroidManifest.xml 這個檔案，只需要在 <activity> 這個標籤裡面加上一個屬性：
android :screenOrientation="landscape"
就大功告成了！
再次執行 App ，就會發現遊戲畫面已經變成橫向了，只要按下 AVD 的 " 螢幕轉向鈕 " ，就是我們一般看到水平螢幕的樣子。
六、【輸出APK】
一般來說， APK 檔會有 2 種版本，一種是 Debug 版本，另一種是 Release 版本。
Debug 版本通常是內部測試使用，未簽署/加密聲明所有權，任何人拿到都可能輕鬆竄改裡面的內容，因此要記得不要外流。
Release 版本則是可以上傳 Google Play 商店並發佈，每次輸出並上傳至 Google Play ， Google 都要認證一個副檔名為 .keystore 的簽署憑證，開發者才能夠持續更新 App 版本。
【Debug版本】
輸出 Debug 版本的方式相當簡單，
Build => Build Bundle(s) / APK(s) => Build APK(s)
當 APK 檔產生完成，會在右下角顯示通知，點擊藍字 " locate " ，就可以快速前往 APK 檔所在的資料夾路徑。
Debug 版本的 APK 安裝時需注意，因為此 APK 沒有經過簽署也並非從 Google Play 商店下載，非常有可能會被 Android 系統的安全防護軟體擋住而安裝失敗。
同時，這種版本的 APK 也無法上傳到 Google Play 並發佈。
【Release版本】
輸出 Release 版本的 APK 需至
Build => Generate Signed Bundle / APK...
雖然目前 Google Play 已經支援 AAB (Android App Bundle) 上傳並發佈，不過這邊只會介紹如何簽署 APK 。
選擇 " APK "
首先要建立一個 keystore 簽署憑證。
" Create new... "
將表格的資訊都填寫完成。
如果一開始不知道怎麼填寫，可以參考萊德的範例。
需要特別注意的是， Key store password 與 Key password 這 2 個可以設定成不同的密碼，但是要牢記！
keystore 建立完成後，會自動帶入 Key store password 與 Key password ，此時可以直接按下 " Next "
*注意： keystore 需妥善保存與備份，密碼也須要牢記，若遺失將無法更新已上線 Google Play 的 App 。
" Build Variants " 選擇 " release " ， " Signature Versions " 可以 " V1 " 與 " V2 " 都勾選，完成後按下 " Finish "
同樣的，當 APK 檔產生完成，會在右下角顯示通知，點擊藍字 " locate " ，就可以快速前往 APK 檔所在的資料夾路徑。
簽署過後 Release 版本的 APK 可以上傳 Google Play 並發佈，也可以不上傳 Google Play ，直接放在網路上供所有人下載。
由於 APK 已經簽署完成，所以安裝在手機時並不會被系統安全防護機制擋下來喔！
視覺小說製作軟體 TyranoBuilder 如何輸出 Android 平台 APK 檔的教學就到這邊~
我們下次見~
接著，來到友人給我的專案資料夾，這個是 TyranoBuilder 輸出的 Android 專案，需要把裡面的內容全部複製起來。
然後到剛剛下載的 Sample 專案，在
main => assets
裡面貼上所有複製的內容。
接著，複製 Sample 專案的 " main " 資料夾。
來到方才 Android Studio 新建立的專案，
app => src => main
把 " main " 整個刪除。
緊接著，把剛剛在 Sample 專案複製的 " main " 資料夾貼上。
回到 Android Studio ，會自動同步檔案內容。
此時可以按下
Build => Make Project
跑跑看。
三、【Debug除錯】
在建置的過程中馬上會發生錯誤。
研究後發現，主要原因是新版的 Android Studio 已經棄用 support 的函式庫，此時要將 MainActivity 當中 import 出現紅字的 Library 刪除，不要 import 它們。
接著來到出現問題的 AlertDialog ，游標移到上面，按下鍵盤
" Alt/Option + Enter " => 選擇 import " android.app "
紅字錯誤即可解決。
或者在 MainActivity 上方手動鍵入 " import android.app.AlertDialog " ，也可以解決紅字錯誤。
修正程式碼之後，再次按下
Build => Make Project
此時就能順利建置專案囉！
四、【建立AVD】
想要查看實際運行的畫面，最簡單的方式就是建立一台 AVD ，也就是 Android 的虛擬機。
如圖所示，
" Open AVD Manager "
" Create Virtual Device... "
選擇機型
下載想要的 Android 系統版本，就可以建立一台 AVD 囉。
好不容易， AVD 已經 Ready 了，就讓我們運行看看吧！
按下工具列像播放鍵的綠色執行鈕 " Run app "
Android Studio 會自動開機你設定好的 AVD ，並運行你的 App 。
咦？畫面怎麼不是橫向的...XD
五、【設定螢幕方向】
原來是因為我們新建的專案還沒有指定這個 MainActivity 的螢幕方向（Orientation），而專案預設都會是垂直方向，當我們想要某個 Activity 的螢幕轉向固定為水平，需要打開
app => manifests
在 AndroidManifest.xml 這個檔案，只需要在 <activity> 這個標籤裡面加上一個屬性：
android :screenOrientation="landscape"
就大功告成了！
再次執行 App ，就會發現遊戲畫面已經變成橫向了，只要按下 AVD 的 " 螢幕轉向鈕 " ，就是我們一般看到水平螢幕的樣子。
六、【輸出APK】
一般來說， APK 檔會有 2 種版本，一種是 Debug 版本，另一種是 Release 版本。
Debug 版本通常是內部測試使用，未簽署/加密聲明所有權，任何人拿到都可能輕鬆竄改裡面的內容，因此要記得不要外流。
Release 版本則是可以上傳 Google Play 商店並發佈，每次輸出並上傳至 Google Play ， Google 都要認證一個副檔名為 .keystore 的簽署憑證，開發者才能夠持續更新 App 版本。
【Debug版本】
輸出 Debug 版本的方式相當簡單，
Build => Build Bundle(s) / APK(s) => Build APK(s)
當 APK 檔產生完成，會在右下角顯示通知，點擊藍字 " locate " ，就可以快速前往 APK 檔所在的資料夾路徑。
Debug 版本的 APK 安裝時需注意，因為此 APK 沒有經過簽署也並非從 Google Play 商店下載，非常有可能會被 Android 系統的安全防護軟體擋住而安裝失敗。
同時，這種版本的 APK 也無法上傳到 Google Play 並發佈。
【Release版本】
輸出 Release 版本的 APK 需至
Build => Generate Signed Bundle / APK...
雖然目前 Google Play 已經支援 AAB (Android App Bundle) 上傳並發佈，不過這邊只會介紹如何簽署 APK 。
選擇 " APK "
首先要建立一個 keystore 簽署憑證。
" Create new... "
將表格的資訊都填寫完成。
如果一開始不知道怎麼填寫，可以參考萊德的範例。
需要特別注意的是， Key store password 與 Key password 這 2 個可以設定成不同的密碼，但是要牢記！
keystore 建立完成後，會自動帶入 Key store password 與 Key password ，此時可以直接按下 " Next "
*注意： keystore 需妥善保存與備份，密碼也須要牢記，若遺失將無法更新已上線 Google Play 的 App 。
" Build Variants " 選擇 " release " ， " Signature Versions " 可以 " V1 " 與 " V2 " 都勾選，完成後按下 " Finish "
同樣的，當 APK 檔產生完成，會在右下角顯示通知，點擊藍字 " locate " ，就可以快速前往 APK 檔所在的資料夾路徑。
簽署過後 Release 版本的 APK 可以上傳 Google Play 並發佈，也可以不上傳 Google Play ，直接放在網路上供所有人下載。
由於 APK 已經簽署完成，所以安裝在手機時並不會被系統安全防護機制擋下來喔！
視覺小說製作軟體 TyranoBuilder 如何輸出 Android 平台 APK 檔的教學就到這邊~
我們下次見~
感謝
回覆刪除美國黑金對治療早洩有一定作用
回覆刪除持久液持久又有力
回覆刪除持久液持久又有力
回覆刪除