首先聲明一點(diǎn),flutter的插件已經(jīng)有不少了,官方的插件,去這里找https://github.com/flutter/plugins
第三方的插件,去這里找https://pub.dev/, (這個(gè)網(wǎng)站有時(shí)候打不開,感覺(jué)應(yīng)該是服務(wù)器的問(wèn)題,請(qǐng)耐心多刷新幾次嘍),
但是難免有時(shí)候還是要自己去寫插件,俗稱自定義插件,才能滿足自己項(xiàng)目的需要.
比方說(shuō),在原生工程里面是用 合作公司的SDK開發(fā)了一個(gè)視頻模塊 (SDK是封裝好的頭文件和一些.a靜態(tài)庫(kù)), 假如現(xiàn)在flutter工程里面也想要這個(gè)視頻模塊,那怎么辦,這個(gè)時(shí)候就需要寫插件了,寫視頻的插件了. 當(dāng)然各位有更好的辦法解決此需求,麻煩請(qǐng)告知我嘍~~
言歸正傳,我們還是回到怎么寫自定義插件.我決定從簡(jiǎn)單到復(fù)雜來(lái)一一介紹
簡(jiǎn)單的--->插件里面只調(diào)用到原生自帶的api,
當(dāng)我們新建一個(gè)插件工程的時(shí)候,官方就給我們提供了一個(gè)示例, 獲取手機(jī)的版本號(hào).這個(gè)示例就是屬于此類. 只用原生自帶的一些api,就可以完成.
點(diǎn)擊Android Studio 新建一個(gè)插件工程,
然后就是下一步,下一步的事情了,建完以后發(fā)現(xiàn)有問(wèn)題,打不開原生工程 翻車了~~
注意觀察哦,沒(méi)有android,也沒(méi)有iOS相關(guān)的東西;還有一點(diǎn)就是 右鍵沒(méi)法用xcode打開了;
來(lái)來(lái)來(lái),現(xiàn)在我們來(lái)看一下flutter 1.20 版本之前的版本建完以后是這樣的
右鍵是可以用xocode打開原生工程的
現(xiàn)在我們來(lái)填坑
我們還是按官方文檔來(lái)解決此坑吧,
官方地址:https://flutter.dev/docs/development/packages-and-plugins/developing-packages#plugin-platforms
其中這個(gè)地方有提到怎么創(chuàng)建插件工程
其中插件工程名為hello. 現(xiàn)在我們要?jiǎng)?chuàng)建一個(gè)工程PlugTest1,所以用下面的命令
1.打開終端,cd 到你要的位置,比喻我就放到桌面
cd Desktop/
2.把上面的語(yǔ)句改一下
flutter create --org com.example --template=plugin --platforms=android,ios -i objc plugTest1
其中 參數(shù) objc 表示iOS工程將會(huì)是用Objective-C語(yǔ)言來(lái)編寫代碼,對(duì)應(yīng)安卓的是java;
同理如果把objc 換成swift,表示iOS工程將會(huì)是用swift語(yǔ)言來(lái)編寫代碼,對(duì)應(yīng)安卓的是kotlin;
3.接著運(yùn)行
flutter run
就會(huì)正常的跑起來(lái).至此新建一個(gè)插件工程的坑填完(此坑是flutter 升級(jí)為1.20后才會(huì)出現(xiàn)的).
如下圖的路徑,就能找到插件實(shí)現(xiàn)的核心代碼(iOS Android)
回到正題
此簡(jiǎn)單插件實(shí)現(xiàn),只調(diào)用到原生自帶的api
iOS
Android
中等---->還會(huì)用到一些第三方的文件或者說(shuō)是用到了第三方庫(kù)
例如我之前寫的一篇文章,關(guān)于實(shí)現(xiàn)udp掃描的插件,http://www.itdecent.cn/p/803660ad39de
就是屬于此類,有興趣的可以看看上面鏈接的那篇文章.
不過(guò)在此 我還是從零開始帶著大家看看,首先用上面的方法新建一個(gè)叫 plugUdp的插件
cd Desktop/
flutter create --org com.example --template=plugin --platforms=android,ios -i objc plugUdp
flutter run
建完之后是這樣的,可以正常運(yùn)行起來(lái)
這里我以iOS為例,同樣的右鍵,用xcode打開原工程
想在xcode里面找到PlugUdpPlugin.h,PlugUdpPlugin.m還是不容易的,路徑比較深的,這里我為了方便大家,把路徑的圖留下來(lái)了
回到正題
寫udp插件,我是用到了GCDAsyncSocket這個(gè)庫(kù)在iOS里面處理socket相關(guān)的比較容易,他有幾個(gè)文件,我們現(xiàn)在要把它放在哪里呢,
經(jīng)過(guò)多番測(cè)試是放在Classes里面是可以的.可以正常用起來(lái)
但是flutter 升級(jí)為1.20后,又不行了
我們來(lái)填坑 (重點(diǎn)就在這里,后面復(fù)雜一點(diǎn)的配置也是以此為基礎(chǔ)的)
1.回到android studio下plugUdp插件工程, 在iOS文件夾下面新建一個(gè)文件夾,比喻Frameworks,把需要的文件放在Frameworks文件夾里面
2.配置podspec文件,把.h .m文件路徑配置進(jìn)去
3.打開終端,cd到工程目錄下的plugUdp/example/ios下,里面有podfile文件
cd /Users/XXXXXX/Desktop/plugUdp/example/ios
4.在終端 安裝一下
pod install
5.再右鍵用xcode打開原生工程
你會(huì)發(fā)現(xiàn)多了一個(gè)叫Frameworks的文件夾,并且里面有相應(yīng)的文件.
在PlugUdpPlugin.h 試著引入頭文件,是正常,并且使用它,
在PlugUdpPlugin.m調(diào)用它里面的方法,也是正常的.
此到大功告成, 坑已填完.
有難度--->插件里面用到 第三方封裝好的sdk,(有framework,有.h頭文件,有.a靜態(tài)庫(kù)等)
怎么在插件里面導(dǎo)入第三方封裝好的Framework,并且能正常使用它,還有些難度的.說(shuō)得更清楚一些就是怎么配置podspec文件.
關(guān)于怎么配置podspec文件 我們?cè)賮?lái)一個(gè)實(shí)例
1.新建一個(gè)plugvideo的插件(前面已經(jīng)多次用到了,不再贅述),用android studio打開插件工程;
2.在ios文件夾下,新建一個(gè)frameworks文件夾,再把.a /.framework文件放進(jìn)去,把.h /.m文件放到Classes文件夾(如下圖第一圖)
3.配置podspec(如下圖第一圖)
4.找到plugvideo插件工程目錄下的podfile文件,進(jìn)行pod install(前面有提到,可以回頭看上面)
5.右鍵用xcode打開原生工程,
6.驗(yàn)證一下是否正常(如下圖第二圖)
最后附上podspec配置遵循的規(guī)則
Pod::Spec.new do |s|
s.name = "XXXSDK"
s.version = "1.0.0"
s.summary = "這是一個(gè)SDK"
s.description = "這是一個(gè)SDK 一定要比summary長(zhǎng)."
s.homepage = "https://github.com/xxxx/XXXSDK"
s.license = { :type => "MIT", :file => "LICENSE" }
s.author = { "作者" => "123456@qq.com" }
s.platform = :ios, "8.0"
# When using multiple platforms ios部署版本
# s.ios.deployment_target = "5.0"
# s.osx.deployment_target = "10.7"
#1 git commit -m =>"13287dd",講pod版本與git倉(cāng)庫(kù)中的某一次提交綁定
#s.source = { :git => "https://github.com/xxxx/XXXSDK", :commit => "13287dd" }
#2 將這個(gè)Pod版本與Git倉(cāng)庫(kù)中某個(gè)版本的comit綁定
#s.source = { :git => "https://github.com/xxxx/XXXSDK", :tag => 1.0.0 }
#3 將這個(gè)Pod版本與Git倉(cāng)庫(kù)中相同版本的comit綁定
#s.source = { :git => "https://github.com/xxxx/XXXSDK", :tag => s.version }
s.source = { :git => "https://github.com/xxxx/XXXSDK.git", :tag => "v#{s.version}" }
s.source_files = "XXXSDK", "XXXSDK/openSource/*.{h,m}"
s.vendored_frameworks = 'XXXSDK/lib/XXXSDK.framework'
s.resources = "XXXSDK/resource/resource.bundle"
s.framework = "UIKit"
#s.resource = "XXXSDK/resource/resource.jpg"
#s.frameworks = "SomeFramework", "AnotherFramework"
#引用libxml2.lib和libz.lib、tbd ，去掉頭尾的lib
# s.library = "z"
# s.libraries = "z", "xml2"
#s.vendored_libraries = 'XXXSDK/lib/XXXSDK.a'
s.requires_arc = true
# s.xcconfig = { "HEADER_SEARCH_PATHS" => "$(SDKROOT)/usr/include/libxml2" }
# s.dependency "JSONKit", "~> 1.4" s.dependency = 'AFNetworking', '~> 2.3' s.dependency = 'SDWebImage'
# 創(chuàng)建子庫(kù)
#s.subspec 'Components' do |ss|
#ss.source_files = 'YDKit/Components/*/.{h,m}'
#end
end
###以下是上面代碼的功能注解
s.name：
名稱
pod search 搜索的關(guān)鍵詞,一定要和.podspec的名稱一樣,否則報(bào)錯(cuò)
s.version：
版本號(hào)
s.ios.deployment_target:
支持的pod最低版本
s.summary:
簡(jiǎn)介
s.homepage:
項(xiàng)目主頁(yè)地址
s.license:
開源協(xié)議(創(chuàng)建github庫(kù)的時(shí)候選擇的)
s.author:
作者信息(這里隨便謝謝也可以通過(guò))
s.social_media_url:
社交網(wǎng)址
s.source:
項(xiàng)目的地址
s.source_files:
需要包含的源文件
s.resource:
資源文件,單個(gè)
s.resources:
資源文件(含bundle)
s.vendored_frameworks:
包含的framework,也就是我們自己制作的pod
s.requires_arc:
是否支持ARC
s.dependency：
依賴庫(kù)，不能依賴未發(fā)布的庫(kù).如AFNetWorking
s.description:
描述,字?jǐn)?shù)要比s.summary長(zhǎng)
s.screenshots:
截圖
s.exclude_files:
隱藏的文件
s.public_header_files:
公開的頭文件
s.framework:
所需的framework,單個(gè)
s.frameworks:
所需的framework,多個(gè)用逗號(hào)隔開
s.library
引用的靜態(tài)庫(kù)
s.libraries
引用的靜態(tài)庫(kù),多個(gè)用逗號(hào)隔開
s.vendored_libraries:
引用自己生成的.a
s.vendored_frameworks:
引用自己生成的.framework,多個(gè)用逗號(hào)隔開
s.dependency:
依賴的庫(kù)
s.ios.deployment_target
iOS部署版本
結(jié)尾
關(guān)于插件這塊,因?yàn)樯婕暗臇|西比較多,所以本來(lái)就是有點(diǎn)復(fù)雜.遇到坑后,就感覺(jué)更難了,這個(gè)時(shí)候,就需要耐心啦.就像看這篇文章一樣,要有耐心把它看完,一邊看,一邊動(dòng)手做,多練幾次,相信會(huì)有收獲的~ 祝君好運(yùn)~~~
如果覺(jué)得有點(diǎn)幫助,請(qǐng)點(diǎn)贊加關(guān)注哦~
