前沿拓展:
win10 桌面 移動
Windows 10的多桌面設計讓用戶更加方便的對任務進行分類管理,使得工作更加井然有序。但是很多用戶可能還不熟悉Windows 10的這個多桌面設計,如果想在在不同桌面之間的窗口互相切換,該如何**作呢? 方法很簡單,具體**作和步驟如下: 1、先轉到待移動窗口的桌面 2、點擊“任務視圖”按鈕或者按Win+Tab,右鍵單擊希望移動擇目標桌面后單擊相應編話甚還號。 注意:Windows 10的
上述是一個登錄模塊的例子,Module 作為基類,定義了模塊的一些生命周期方法。LoginModule是對外公開的業(yè)務接口,里面僅包含外部會用到的和登錄業(yè)務相關的方法。LoginModuleImplV1類是登錄邏輯的具體實現,不對外公開,里面的私有成員變量和方法對外部是隱藏的,同時實現了Module和LoginModule的接口。Provider用于創(chuàng)建和管理Module實例。這里采用的思路是,底層模塊和模塊之間,上層和底層之間只依賴接口頭文件,頭文件內包含有限的需要對外暴露的接口。通過XModule這個框架,將實現和接口進行分離。為了將接口和實現分離,用到了 pimpl (Pointer to Implementation) 的理念,將對象的實現細節(jié)隱藏在指針背后。LoginModule接口負責定義對外公開的API,LoginModuleImplV1類負責定義LoginModule的具體實現,也就是調用的指針實際指向的對象。調用方只能知道LoginModule中公開的API,而無法知道LoginModuleImplV1的實現細節(jié),可以降低調用方的使用門檻,也可以降低錯誤使用的可能性。pimpl不僅解除了接口和實現之間的耦合關系,還可以降低文件間的編譯依賴關系,起到“編譯防火墻”的作用,可以提高一定的編譯效率。
// LoginModuleProvider 通過宏自動生成X_MODULE_PROVIDER_DEFINE_SINGLE(LoginModule, MIN_VERSION, MAX_VERSION);// LoginModuleImplV1Provider 通過宏自動生成X_MODULE_DEFINE_SECONDARY_PROVIDER(LoginModuleImplV1, LoginModule);
XModule的模版開發(fā)方式,會增加很多類文件,為了方便,通過宏來控制Provider類的自動生成。其中MIN_VERSION和MAX_VERSION是該Module接口能支持的最小和最大的版本范圍,可以限制后期dll插件化加載時,不加載在版本之外的dll,避免產生沖突和錯誤,目前Provider的GetVersion使用的是MAX_VERSION。
// 由 X_MODULE_DEFINE_SECONDARY_PROVIDER 宏自動生成class DLLEXPORT LoginModuleImplV1Provider : public LoginModuleProvider {public: LoginModule* Create() const { LoginModuleImplV1* p = new LoginModuleImplV1(); ((Module*)p)->OnCreate();return p; } };
LoginModuleImplV1Provider可以通過調用Create方法拿到對應的LoginModuleImplV1實例。
x_module::ModuleCenter* module_center = x_module::ModuleCenter::GetInstance();module_center->AcceptProviderType<LoginModuleProvider>();
ModuleCenter是所有Module的管理類,先通過x_module::ModuleCenter::GetInstance()拿到ModuleCenter的實例,它是一個跨dll的單例。第二要用之前的LoginModuleProvider去注冊一個Module類型到ModuleCenter中。LoginModuleProvider中定義了支持的Module類型,以及最小版本和最大版本,如果后續(xù)掃描到的dll中提供的對應類型的Provider中GetVersion返回的值不在最大版本和最小版本之間,那么就不會被允許加載進來。
module_center->AddProvider(new LoginModuleImplV1Provider());
通過這種方式,可以將LoginModuleImplV1Provider注冊到ModuleCenter中,第二創(chuàng)建并管理LoginModuleImplV1的實例。但是這樣就顯式地依賴了LoginModuleImplV1Provider,違反了前面說過的依賴倒置原則,對開閉原則也不友好,因為這樣就只能通過修改代碼來實現擴展了。
#include <x_module/connector.h>#include “login_module/login_module_impl.h”X_MODULE_CONNECTORbool XModuleConnect(x_module::Owner& owner) { owner.add(new LoginModuleImplV1Provider());return true;}
為了在加載dll時,來注冊Provider,增加了一個connector.cc,添加一個XModuleConnect方法,讓dll被加載之后,能夠找到XModuleConnect這個符號方法,并進行調用,在XModuleConnect被調用的時候,會調用AddProvider將Provider進行注冊。
std::string path = GetProgramDir();module_center->Install(path, “login_module”);
由于目前l(fā)ogin_module.dll是直接放在exe同目錄的,所以這里直接獲取了一下exe絕對路徑,第二調用Install方法,將路徑和dll名login_module傳入進去,這樣就完成了注冊。
auto* p_login_module = module_center->ModuleFromProtocol<LoginModule, LoginModuleProvider>();if (p_login_module == ptr) { (*move_result)->Error(“-100”, “login module 為空”);return;}bool islogin = p_login_module->IsLogin();
在使用時,只需要LoginModule和LoginModuleProvider這兩個抽象,就能獲取真實的LoginModuleImplV1這個實例,調用方僅需關心LoginModule所公開的API,完全屏蔽了對實現的依賴。后續(xù)底層擴展成了LoginModuleImplV2,只要LoginModule的公開API不變,對上層是無感知的。這種方式完全遵循了前面提到的設計原則,對團隊內的多人維護以及后續(xù)的更新迭代都帶來了穩(wěn)定的保障。
基于vcpkg的C++依賴管理
模塊拆分之后,帶來的副作用就是依賴管理會變得更加復雜,到C++這邊就是CMakeLists的膨脹。從移動端的角度來看這個問題,Android可以通過Gradle來管理依賴,依賴庫構建成aar之后上傳到Maven倉庫,implementation ‘androidx.recyclerview:recyclerview:1.1.0’像這樣通過包名、庫名和版本號來依賴具體的庫。iOS有CocoaPods,通過添加pod ‘AFNetworking’, ‘~> 2.6’到Podfile來完成依賴的添加。前端也有NPM這樣的包管理器,所有依賴都在package.json這個文件中聲明和管理。Flutter側也可以通過pubspec來管理各個依賴庫。為了獲得一致的體驗,解決C++側依賴管理的痛點,我們引入了微軟官方推出的vcpkg,vcpkg的清單模式可以得到類似的體驗。
依賴庫配置
這里以fish-ffi-module模塊為例子,文件結構如下,其中include文件里面是對外公開的頭文件,src文件包含當前庫內部使用的代碼,cmake文件下的config.cmake.in模版文件用于生成xxx-config.cmake的文件,用于被find_package找到。
.├── CMakeLists.txt├── LICENSE├── cmake│ └── config.cmake.in├── include│ └── fish_ffi_module.h├── src│ ├── connector.cc│ ├── fish_ffi_module_impl_v1.cc│ └── fish_ffi_module_impl_v1.h├── vcpkg-configuration.json└── vcpkg.json
vcpkg-configuration.json配置了私有源,后面會講到。vcpkg.json文件,聲明了當前庫所依賴的其他庫,即vcpkg的依賴清單,其中”dependencies”字段聲明了所使用的依賴名稱。
{“name”: “fish-ffi-module”,“version”: “1.0.0”,“description”: “A fish-ffi module based on fish-ffi-sdk.”,“homepage”: “”,“dependencies”: [“fish-ffi-sdk”,“x-module”,“flutter-sdk” ]}
CMake工程最重要的就是CMakeLists文件了,里面配置了編譯相關的設置,添加了相關的注釋來幫助理解。
cmake_minimum_required(VERSION 3.15)# 倉庫版本常量,升級時修改set(FISH_FFI_MODULE_VERSION “1.0.0”)project(fish-ffi-module VERSION ${FISH_FFI_MODULE_VERSION} DESCRIPTION “A fish-ffi module based on fish-ffi-sdk.” HOMEPAGE_URL “” LANGUAGES CXX)option(BUILD_SHARED_LIBS “Build using shared libraries” ON)# vcpkg清單中添加依賴之后,通過find_package就能找到find_package(fish-ffi-sdk CONFIG REQUIRED)find_package(flutter-sdk CONFIG REQUIRED)find_package(x-module CONFIG REQUIRED)# configure_package_config_file 生成config要用到include(CMakePackageConfigHelpers)# install 安裝要用到include(GNUInstallDirs)# 當前庫的頭文件和源文件aux_source_directory(include HEADER_LIST)aux_source_directory(src SRC_LIST)add_library(fish-ffi-module SHARED${HEADER_LIST}${SRC_LIST})# 設置別名add_library(fish-ffi-module::fish-ffi-module ALIAS fish-ffi-module)# 設置動態(tài)庫導出宏,PRIVATE為編譯時,INTERFACE為運行時if (BUILD_SHARED_LIBS AND WIN32)target_compile_definitions(fish-ffi-module PRIVATE “FISH_FFI_MODULE_EXPORT=__declspec(dllexport)” INTERFACE “FISH_FFI_MODULE_EXPORT=__declspec(dllimport)”)endif ()target_compile_features(fish-ffi-module PUBLIC cxx_std_17)# 添加頭文件target_include_directories(fish-ffi-module PUBLIC lt;BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include/> lt;INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>)# 鏈接庫文件target_link_libraries(fish-ffi-module PRIVATE fish-ffi-sdk::fish-ffi-sdk)target_link_libraries(fish-ffi-module PRIVATE flutter-sdk::flutter-sdk)target_link_libraries(fish-ffi-module PRIVATE x-module::x-module)# 基于config.cmake.in的模板生成xxx-config.cmake的文件configure_package_config_file( cmake/config.cmake.in${CMAKE_CURRENT_BINARY_DIR}/fish-ffi-module-config.cmake INSTALL_DESTINATION ${CMAKE_INSTALL_DATADIR}/fish-ffi-module NO_SET_AND_CHECK_MACRO)# 生成xx-config-version.cmake文件write_basic_package_version_file(${CMAKE_CURRENT_BINARY_DIR}/fish-ffi-module-config-version.cmake VERSION ${FISH_FFI_MODULE_VERSION} COMPATIBILITY SameMajorVersion)# 將上面生成的兩個config文件,安裝到share/fish-ffi-module下install( FILES${CMAKE_CURRENT_BINARY_DIR}/fish-ffi-module-config.cmake${CMAKE_CURRENT_BINARY_DIR}/fish-ffi-module-config-version.cmake DESTINATION${CMAKE_INSTALL_DATADIR}/fish-ffi-module)# 安裝頭文件install(DIRECTORY include/ DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})# install targetinstall(TARGETS fish-ffi-moduleEXPORT fish-ffi-module-targets RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR} LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR} ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR})# 導出install(EXPORT fish-ffi-module-targets NAMESPACE fish-ffi-module:: DESTINATION ${CMAKE_INSTALL_DATADIR}/fish-ffi-module)
這里面最重要的一點是配置xx-config.cmake和xx-config-version.cmake的生成,vcpkg會在源碼首次拉下來的時候進行編譯,編譯完在相應庫的share目錄生成上述兩個文件,并且在CMake配置階段執(zhí)行,這樣在使用find_package的時候就能獲取到這個庫以及對應版本號。小編綜合來說一下就是,vcpkg幫助完成了代碼的下載、編譯和配置,第二就可以方便的鏈接三方庫了。
自定義私有源
私有源的自定義非常簡單,其實就是個Git倉庫,push到私有的git托管服務上即可。只需要將依賴庫的最新commit信息記錄到這個倉庫里面,通過模版化的配置就能完成依賴庫的發(fā)布。
.├── ports│ ├── fish-ffi-module│ │ ├── portfile.cmake│ │ └── vcpkg.json│ └── x-module│ ├── portfile.cmake│ └── vcpkg.json├── versions│ ├── f-│ │ └── fish-ffi-module.json│ └── x-│ │ └── x-module.json│ └──baseline.json└── LICENSE
vcpkg里面對依賴庫的定義叫port,這里定義了兩個port,分別是fish-ffi-module和x-module。其中的文件說明如下:
? portfile.cmake中定義了這個庫的git地址、分支、commitId、編譯配置等信息
? vcpkg.json定義了這個port的依賴以及版本信息,如果有依賴,則會在編譯這個庫之前優(yōu)先編譯依賴。
? versions下的文件按首字母分類,里面定義了version和git-tree的對應關系。在port新增或更新之后,git-tree需要重新生成,通過git rev-parse HEAD:ports/x-module來生成git-tree,第二通過git commit –amend追加提交到剛剛的commit中。
在需要使用私有源的CMake工程根目錄,添加vcpkg-configuration.json,里面內容如下。default-registry為默認源,指向官方的地址即可。registries下添加自定義的私有源,再通過指定packages,表示里面的庫需要在這個私有源查找。這樣就完成了私有源的配置。
{“default-registry”: {“kind”: “git”,“repository”: “https://github.com/microsoft/vcpkg”,“baseline”: “f4b262b259145adb2ab0116a390b08642489d32b” },“registries”: [ {“kind”: “git”,“repository”: “xxx.git”,“baseline”: “1ad54586a5a2fadb8c44d3f8f47754e849fc5a38”,“packages”: [ “x-module”, “fish-ffi-sdk”, “fish-ffi-module”] } ] }
在versions文件夾下還有一個baseline.json的文件,這個文件主要是設置基線用的,不像其他的依賴管理工具,vcpkg主要是通過這個基線來設置當前所使用的版本號的。vcpkg可以勝任依賴管理的相關工作,綜上所述只是一個簡單使用,相比其他平臺的依賴管理工具略顯繁瑣,除此之外還有很多其他能力,需要到vcpkg.io的官方文檔里面探索了。
小編綜合來說
Flutter應用接入Windows平臺,主要遇到的問題就是Windows側的一些能力的提供,需要對齊Android和iOS的已有能力。因為使用的是C++的開發(fā)語言,對于移動端開發(fā)者并不是那么友好,學習曲線相對會比較抖。不過一旦平臺側的能力完善之后,又可以回歸到Flutter這個熟悉的領域了,享受Flutter開發(fā)帶來的便捷。此外Windows應用的開發(fā)不僅僅只是屏幕加大版的移動端開發(fā),還包括不同的輸入設備(鍵盤鼠標)、交互習慣、樣式風格、**作系統(tǒng)特性等,為了更好的平臺體驗,會帶來一定的適配成本,這一塊后續(xù)也將持續(xù)投入。
拓展知識:
原創(chuàng)文章,作者:九賢生活小編,如若轉載,請注明出處:http:///119239.html