怎樣在chrome中內置擴展，以及一些簡單的定製

本文中chromium 版本爲54

參考資料：

chromium如何新增extension API以及添加內部擴展

http://slides.com/luyuan/grit#/

---

 

1、嵌入擴展

 

1. 複製擴展的資源文件夾，到 src\chrome\browser\resources\ 文件夾下，

其中manifest.json文件的「key」的來源：經過載入一個自定義的crx插件而後在chromium的appdata下找到該插件的key，該key可能被用於計算extension-id，若是擴展沒法調用接口，有多是key不對，在src\base\base64.cc的Base64Decode函數處作檢查。

(在chromium中用開發者模式添加你的擴展,找到用戶數據中以id命名的文件夾,獲得manifest.json中的key)

若是沒有這個key，chromium啓動就會崩潰。

 

2. 在src\chrome\browser\extensions\component_loader.cc文件下，

AddDefaultComponentExtensions()函數中添加:

 

  Add(IDR_EXTENSION_MANIFEST,
      base::FilePath(FILE_PATH_LITERAL("extension_name")));

 

 

IDR_EXTENSION_MANIFEST的定義見下面

 

 

3.在src\chrome\browser\browser_resources.grd 文件下，定義一個ID IDR_EXTENSION_MANIFEST跟擴展mainfest.json的關聯

 

   

   <include name="IDR_EXTENSION_MANIFEST" file="resources\extension_dir\manifest.json" type="BINDATA" />

 

 

　　這裏的resources\就是上面（1）中的 src\chrome\browser\resources\

 

4.在src\chrome\browser\extensions\component_extensions_whitelist\whitelist.cc文件,   

 bool IsComponentExtensionWhitelisted(int manifest_resource_id)函數中添加:

 case IDR_EXTENSION_MANIFEST:

 

 

 

5.把web資源添加到src\chrome\browser\resources\component_extension_resources.grd文件中，用於資源打包，必須把除了mainfest.json文件以外的其餘獨立文件都加進來。

附件：python腳本，從extension目錄生成相應的xml聲明

 

2、其它修改

1.安裝後首次運行的歡迎頁面URL

src\chrome\app\resources\locale_settings.grd 中修改 IDS_WELCOME_PAGE_URL

 

 

2.改圖標

   替換

   src\chrome\app\theme\chromium

   src\chrome\app\theme\default_100_percent\chromium

   src\chrome\app\theme\default_200_percent\chromium

   下面相關的圖片

   exe圖標在資源文件src/chrome/app/chrome_exe.rc中定義IDR_MAINFRAME，chrome.dll裏也定義了一個IDR_MAINFRAME，在chrome_dll.rc中。

 

3.菜單修改

以新建標籤爲例：

符號定義：src\chrome\app\chrome_command_ids.h(49):#define IDC_NEW_TAB                     34014  

命令執行：src\chrome\browser\ui\browser_command_controller.cc(367):    case IDC_NEW_TAB:  

初始化狀態：src\chrome\browser\ui\browser_command_controller.cc(802)  BrowserCommandController::InitCommandState

添加菜單項：src\chrome\browser\ui\toolbar\app_menu_model.cc(787):  AddItemWithStringId(IDC_NEW_TAB, IDS_NEW_TAB);  

 

4.改產品名稱

 

• src\chrome\app\chromium_strings.grd 中的 IDS_PRODUCT_NAME 和其它帶Chromium字樣的字符串，IDS_PRODUCT_NAME 也出如今關於頁面中
• src\chrome\app\resources\chromium_strings_XX.xtb 等語言相關的文件中的Chromium字樣，主要是<translation id = "2910007522516064972">&Chromium Browser সম্পর্কে< / translation>這句(關於chrome...）。
• src\components\components_chromium_strings.grd : IDS_VERSION_UI_LICENSE （關於...頁面下面的感謝聲明）
• src\components\strings\components_chromium_strings_en-GB.xtb  <translation id="4365115785552740256"> 同上,還有其它語言的

• <translation id="459535195905078186">Chromium 應用</translation>   改爲  <translation id="459535195905078186">Chromium Browser 應用</translation>

 

 

5.移除「缺乏Google API 密鑰……」的警告

找到src\chrome\browser\ui\startup\startup_browser_creator_impl.cc GoogleApiKeysInfoBarDelegate::Create一句

    GoogleApiKeysInfoBarDelegate::Create(InfoBarService::FromWebContents( 
        browser->tab_strip_model()->GetActiveWebContents()));

 

，註釋掉。

注：這個警告是編譯時 google_api_key = "no" 的結果，不使用api key，你定製的瀏覽器就無法登陸google帳戶。

 

 

6.在代碼中加命令行參數

  src\chrome\app\chrome_main_delegate.cc ChromeMainDelegate::BasicStartupComplete 中

bool ChromeMainDelegate::BasicStartupComplete(int* exit_code) {
 
  base::CommandLine& command_line =
      *base::CommandLine::ForCurrentProcess();
  // add custom switches 
  command_line.AppendSwitch(switches::kProcessPerSite);
  command_line.AppendSwitch(switches::kEnableExperimentalWebPlatformFeatures);  

　　

  

7.獲取chrome APP的app-id

進入 chrome://extensions/ =》 開發者模式 =》 加載APP =》 詳細信息 =》建立快捷方式 =》 快捷方式屬性裏有 --app-id=xxxxxx

 

8.修改navigator.userAgent/appVersion的值

src\third_party\WebKit\Source\core\loader\FrameLoader.cpp 

String FrameLoader::userAgent() const

第一行

String userAgent = client()->userAgent();

改成：

String userAgent = String::format("%s 你想加的內容/1.0.0.5", client()->userAgent().utf8().data());

注：由於沙箱的緣由，這樣硬編碼只是權宜之計，最好是跟browser process通訊得到本地配置文件中的版本信息。

 

 

附件：

grd_generator.py

# -*- coding: utf-8 -*-

import os

from Tools.scripts.treesync import raw_input


def traverse(rootDir):
    for lists in os.listdir(rootDir):
        path = os.path.join(rootDir, lists)
        if os.path.isfile(path):
            if os.path.basename(path) == 'manifest.json':
                continue
            rel_path = os.path.relpath(path, parent_dir)
            symbol = rel_path.replace('\\', '_').replace('-', '_').replace('.', '_').upper()
            print('<include name="IDR_' + symbol + '" file="' + rel_path + '" type="BINDATA" />')
        # print(path)
        if os.path.isdir(path):
            traverse(path)


dir = raw_input('請輸入擴展文件夾路徑：').strip('\n')
parent_dir = os.path.abspath(os.path.join(dir, os.pardir))
traverse(dir)