2.1.0版本中,已完成對OPPO小游戲的適配與發布功能。今天,我們開啟了該功能的開關。已下載使用.1.0版本的開發者,重啟IDE進入即可看到功能。老版本IDE的開發者升級2.1.0beta版本即可使用OPPO小游戲的功能。
OPPO小游戲背景
OPPO是快應用聯盟中的重要成員。據了解,快應用過去一年覆蓋10億設備、月活2億、打開快應用20億次、留存1億個桌面圖標。其中有35%的流量來自桌面留存的圖標。
基于快應用聯盟強大的設備基礎,快游戲具有先天的設備覆蓋及獲客優勢,一旦接入快游戲平臺,它可以在聯盟廠商手機品牌中得到推廣。OPPO小游戲引入等引擎方對其適配,并在引擎IDE中一鍵發布,這對于廣大的游戲廠商而言,無疑帶來了更快的游戲發布效率,并且可以將開發者的接入成本最小化。
如今OPPO小游戲開放了各個重要的流量入口,例如:OPPO瀏覽器、軟件商店、游戲中心、桌面搜索、負一屏鎖屏、語音助手、OPPO+、閱讀等。巨大流量入口讓小游戲研發廠商又再增一個新的重量級發布渠道。
OPPO小游戲發布與調試環境準備
1、OPPO品牌的手機。
2、下載安裝OPPO真機測試APP "快應用"。
OPPO 小游戲調試器地址:
或者前往OPPO官網文檔:
3、PC電腦的瀏覽器與手機數據連接線。
4、安裝 環境,建議安裝 8.x 穩定版本 [node官網:]
就是下載安裝,比較簡單,也不細介紹。能在命令行里調起npm命令就算是成功了。
5、集中開發環境, 2.1.0 beta 或以上版本 [ 官網下載: ]
6、安裝ADB Shell
OPPO發布需要通過ADB Shell把rpk包推到games目錄上去,所以這個必須要裝。
[ ADB官網下載: ]
提示一下,下載 ADB Kits,下載后的壓縮包,建議解壓放到一個路徑簡單一些的目錄(如: D:\adb)。要記得添加環境變量(不知如何添加環境變量的可自行百度)。
OPPO小游戲發布前準備工作檢查
1、發布前的準備工作檢查。
為了讓發布OPPO順利一些,有一些檢查工作我們要做。
第一、PC里,node環境、ADB Shell、這些,都必須要安裝好。
第二、在OPPO的手機里,進入設置-> 其它設置-> 開發者選項 ,開發者選項與USB調試必須開啟,如圖1所示。
(圖1)
另外要確保安裝好OPPO小游戲調試環境“快應用”,如圖2所示。
(圖2)
第三、將PC電腦與手機用USB數據線相連,電腦里,可以出現類似圖3一樣的界面。比如,點擊圖3左上角的OPPO R9m,就可以進入手機存儲。
(圖3)
手機里要注意的是,屏幕保持點亮打開,在PC的IDE發布OPPO小游戲時,如果手機出現授權信息請求的時候,一定要點確定允許。如圖4所示。
(圖4)
發布OPPO小游戲包(xx.rpk)
打開發布功能,在發布平臺選擇好OPPO小游戲之后,如圖5所示,我們就可以在當前的界面里配置發布的相關參數,然后完成一鍵發布。
(圖5)
常規的發布就不介紹了。關于OPPO小游戲專屬的發布配置如圖6所示。我們將逐一進行介紹。
(圖6)
1、游戲名稱
一般都填寫中文漢字,英文也可以。用于應用商店、桌面圖標、彈窗等游戲入口處。一個好的名字是游戲能不能吸量的重要元素。OPPO是10個漢字以內就可以。我們的建議是都不要超過6個漢字,游戲名太長沒什么好處。
2、游戲包名
游戲包名的格式是pany.第一位com不要變,第二位是公司名,第三位是項目名。都要寫英文,例如:com..。
3、游戲圖標
游戲圖標也是重要的游戲入口標識,和游戲名稱一樣,是非常重要的吸量元素,如果游戲圖標設計的好,游戲名稱起的好。同樣的位置會獲得比其它游戲更多的點擊率。游戲圖標需要提供192 * 192的正方形尺寸。
4、游戲版本名稱
游戲版本名稱是真實的版本,一般是用于功能性版本的區別。比如我有個大版本改動。原來是1.0,可以變成2.0,如果只是改改Bug,那1.0完全可以改成1.1。以此類推,我們建議采用浮點數命名。比如“0.1”、“1.3”、“5.0”……
5、游戲版本
游戲版本與版本名稱用處不同,這里是渠道平臺用于區別版本更新。每次提審都要至少遞歸+1,自己測試無所謂。但是提審這里的值必須要比上次提審的值至少要+1,+N也是可以的,絕對不能等于或者小于上個版本值,建議是提審版本號遞歸+1。這里需要注意的是,游戲版本必須為正整數。
6、最小平臺號
最小平臺號,目前只能設置為1040,未來有變更或者有了其它更新方式,請及時關注本文檔。
7、屏幕方向
這里和微信小游戲的橫豎屏設置一樣,大家要注意和游戲實際以及引擎的橫豎屏設置保持統一。
8、打包完成后啟動手機調試
這個選項是用于啟動真機調試用的。
OPPO需要真機調試的時候,發布時必須勾選文件解壓后怎么全部覆蓋到游戲目錄,并且要保障PC環境中已安裝了ADB Shell [ ADB官網下載: ],同時還要確保手機與PC是聯通的,并且打開了USB調試權限。
9、是否使用正式版簽名
如果只是測試版本調試,這里可以不用勾選。正式上線發布前(提版本到平臺)必須勾選。
如果勾選了,就會啟用正式版簽名。關于簽名:
①對于公司,一般一個公司只用一個簽名,如果公司已經有簽名了,推薦使用公司的簽名。如果沒有的話,IDE中的發布集成了這個功能,方便開發者生成簽名。
②對于個人開發者,可以多個項目使用一個正式簽名。只需要生成一次即可。
如果已經有簽名了,將簽名文件放到項目根目錄sign / 文件夾下,如圖7所示。
(圖7)
放到根目錄下,是為了下次發版本的時候,復制到的目錄下。如果直接到目錄內的sign目錄內,下次發布會把之前的內容全部清除掉。如果沒有sign/,那就自己建一個!
10、生成簽名
這個功能是為了生成正式版簽名,不勾選上一個功能或者已經有簽名的時候,不用配置這里。勾選后,配置參數如下(注意生成簽名需要環境):
(圖8)
簽名內容建議寫英文,幫大家翻譯一下及示例如下:
//國家簡稱,例如中國CN
Country Name (2 letter code) [AU]:
CN
//省或直轄市名字,例如北京市BeiJing
State or Province Name (full name) [Some-State]:
BeiJing
//區或市縣的名稱,例如海淀區HaiDian
Locality Name (eg, city) []:
HaiDian
//公司或組織名,例如Layabox
Organization Name (eg, company) [Internet Widgits Pty Ltd]:
Layabox
//單位或者是部門名稱,例如游戲部門Game
Organizational Unit Name (eg, section) []:
Game
//Email地址,例如:游戲對接合作 bd@layabox.com
Email Address []:
bd@layabox.com
填寫完以上的配置信息,點擊發布,即可完成發布。需要提醒的是,首次發布需要下載rpk環境文件解壓后怎么全部覆蓋到游戲目錄,要稍等一會。別著急。
真機調試與輸出
OPPO的調試必須基于真機調試,PC的只能輸出信息,看不到畫面。
如果準備工作沒問題的話,正常情況下,里成功發布OPPO小游戲之后,是rpk的包會自動出現在快游戲的OPPO小游戲列表中的(IDE通過調用ADB Shell推到指定的目錄中),如圖9所示。
(圖9)
圖5中的OPPO測試就是我們在發布的時候填寫的游戲名稱。如果我們看到自己對應的游戲名稱,說明是正常發布成功了。點擊秒開,就可以打開我們發布的游戲。
如果想看調試信息。這時就需要打開瀏覽器。然后在輸入欄里輸入:
chrome-devtools://devtools/bundled/inspector.html?v8only=true&ws=10.10.82.111:12345/00010002-0003-4004-8005-000600070008
上面示例的IP地址10.10.82.111替換成自己手機上的IP就行。IP地址不知道怎么查的,自行百度。這里重點提示的是,PC電腦必須要和手機處于同一個網段的局域網環境下。
如果沒問題,PC中的調試效果如圖10所示。
(圖10)
發布后調試列表中未見游戲的處理經驗
在正常情況下,通過是一鍵發布到手機里的,如果發布的時候沒能將rpk自動發到快游戲目錄內,那就沒辦法直接看到剛發布的小游戲(看上面的圖9)。這時需要檢查adb shell是不是安裝好了,上面圖1的授權是不是開啟了,大多數是adb shell的問題或者與授權有關。
我們可以在PC的命令行下,輸入adb shell查看,如圖11所示。則是未獲得USB調試模式授權。
(圖11)
這時,我們要檢查相關的設置。設置好之后,再次輸入adb shell,應該如圖12所示。這時候說明adb shell與授權沒問題了。
(圖12)
這些搞定后,我們再重新發布,應該就沒問題了。
如果還有問題,一方面把問題反饋給官方團隊,會與OPPO團隊共同處理。另一方面,我們可以采用手工模式,把rpk包,復制到手機存儲的games目錄下,如果沒有games目錄則自己手工創建一下。
rpk包位于項目的///dist 目錄下,如圖13所示。
(圖13)
將發布生成的rpk文件,復制到手機存儲的games目錄下,如圖14所示。
(圖14)
這種方式,肯定能被OPPO小游戲的調試環境識別的。至此,我們應該可以順利的發布和調試OPPO小游戲了。未來,引擎還會適配和支持更多游戲平臺的發布。請開發者關注公眾號獲得一手消息。