Search

㊗ 新的一年,祝福讀者們 2020 新年新希望!! ◆ Welcome to Laird Studio! 歡迎蒞臨萊爾德工作室! ◎ Android Studio 基礎教學籌備中,敬請期待! ☏ 對網站有任何問題或建議,都非常歡迎使用留言板或至 Facebook 粉絲團發訊息,讓我們知道您的想法 (੭ु´ ᐜ `)੭ु

2020年1月6日 星期一

[ 教學 ] [ Android Studio ] 視覺小說製作軟體 TyranoBuilder 如何輸出 Android 平台 APK 檔


最近萊德受友人所託,幫忙研究了一下 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 專案,解壓縮之後,裡面的結構會與下圖相同。

http://tyrano.jp/download/player/TyranoPlayerFramework_android_v112.zip


相信開發過 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 passwordKey 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 檔的教學就到這邊~

我們下次見~



4 則留言: