第二部分 OpenCore的代碼結(jié)構(gòu)2.1 代碼結(jié)構(gòu)
以開源Android的代碼為例,OpenCore的代碼在以下目錄中:external/opencore/。這個目錄是OpenCore的根目錄,其中包含的子目錄如下所示:
android:這里面是一個上層的庫,它基于PVPlayer和PVAuthor的SDK實現(xiàn)了一個為Android使用的Player和Author。
baselibs:包含數(shù)據(jù)結(jié)構(gòu)和線程安全等內(nèi)容的底層庫
codecs_v2:這是一個內(nèi)容較多的庫,主要包含編解碼的實現(xiàn),以及一個OpenMAX的實現(xiàn)
engines:包含PVPlayer和PVAuthor引擎的實現(xiàn)
extern_libs_v2:包含了khronos的OpenMAX的頭文件
fileformats:文件格式的解析(parser)工具
nodes:提供一些PVMF的NODE,主要是編解碼和文件解析方面的。
oscl:操作系統(tǒng)兼容庫
pvmi: 輸入輸出控制的抽象接口
protocols:主要是與網(wǎng)絡(luò)相關(guān)的RTSP、RTP、HTTP等協(xié)議的相關(guān)內(nèi)容
pvcommon:pvcommon庫文件的Android.mk文件,沒有源文件。
pvplayer:pvplayer庫文件的Android.mk文件,沒有源文件。
pvauthor:pvauthor庫文件的Android.mk文件,沒有源文件。
tools_v2:編譯工具以及一些可注冊的模塊。
在external/opencore/目錄中還有2個文件,如下所示:
Android.mk:全局的編譯文件
pvplayer.conf:配置文件
在external/opencore/的各個子文件夾中包含了眾多的Android.mk文件,它們之間還存在著“遞歸”的關(guān)系。例如根目錄下的Android.mk,就包含了如下的內(nèi)容片斷:
include $(PV_TOP)/pvcommon/Android.mk
include $(PV_TOP)/pvplayer/Android.mk
include $(PV_TOP)/pvauthor/Android.mk
這表示了要引用pvcommon,pvplayer和pvauthor等文件夾下面的Android.mk文件。
external/opencore/的各個Android.mk文件可以按照排列組合進行使用,將幾個Android.mk內(nèi)容合并在一個庫當中。
2.2 編譯結(jié)構(gòu)
1.庫的層次關(guān)系:在Android的開源版本中編譯出來的內(nèi)容,OpenCore編譯出來的各個庫如下所示:
libopencoreauthor.so:OpenCore的Author庫
libopencorecommon.so:OpenCore底層的公共庫
libopencoredownloadreg.so :下載注冊庫
libopencoredownload.so:下載功能實現(xiàn)庫
libopencoremp4reg.so:MP4注冊庫
libopencoremp4.so:MP4功能實現(xiàn)庫
libopencorenet_support.so:網(wǎng)絡(luò)支持庫
libopencoreplayer.so:OpenCore的Player庫
libopencorertspreg.so:RTSP注冊庫
libopencorertsp.so:RTSP功能實現(xiàn)庫
這些庫的層次關(guān)系如下圖所示:

OpenCore的各個庫之間具有如下的關(guān)系:
libopencorecommon.so是所有的庫的依賴庫,提供了公共的功能;
libopencoreplayer.so和libopencoreauthor.so是兩個并立的庫,分別用于回放和記錄,而且這兩個庫是OpenCore對外的接口庫;
libopencorenet_support.so提供網(wǎng)絡(luò)支持的功能;
一些功能以插件(Plug-In)的方式放入Player中使用,每個功能使用兩個庫,一個實現(xiàn)具體功能,一個用于注冊。
2.libopencorecommon.so庫的結(jié)構(gòu)
libopencorecommon.so是整個OpenCore的核心庫,它的編譯控制的文件的路徑為pvcommon/Android.mk,這個文件使用遞歸的方式尋找子文件:include $(BUILD_SHARED_LIBRARY)
include $(PV_TOP)//oscl/oscl/osclbase/Android.mk
include $(PV_TOP)//oscl/oscl/osclerror/Android.mk
include $(PV_TOP)//oscl/oscl/osclmemory/Android.mk
include $(PV_TOP)//oscl/oscl/osclutil/Android.mk
include $(PV_TOP)//oscl/pvlogger/Android.mk
include $(PV_TOP)//oscl/oscl/osclproc/Android.mk
include $(PV_TOP)//oscl/oscl/osclio/Android.mk
include $(PV_TOP)//oscl/oscl/osclregcli/Android.mk
include $(PV_TOP)//oscl/oscl/osclregserv/Android.mk
include $(PV_TOP)//oscl/unit_test/Android.mk
include $(PV_TOP)//oscl/oscl/oscllib/Android.mk
include $(PV_TOP)//pvmi/pvmf/Android.mk
include $(PV_TOP)//baselibs/pv_mime_utils/Android.mk
include $(PV_TOP)//nodes/pvfileoutputnode/Android.mk
include $(PV_TOP)//baselibs/media_data_structures/Android.mk
include $(PV_TOP)//baselibs/threadsafe_callback_ao/Android.mk
include $(PV_TOP)//codecs_v2/utilities/colorconvert/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/amr_nb/common/Android.mk
include $(PV_TOP)//codecs_v2/video/avc_h264/common/Android.mk
這些被包含的Android.mk文件真正指定需要編譯的文件,這些文件在Android.mk的目錄及其子目錄中。事實上,在libopencorecommon.so庫中包含了以下內(nèi)容:
OSCL的所有內(nèi)容
Pvmf框架部分的內(nèi)容(pvmi/pvmf/Android.mk)
基礎(chǔ)庫中的一些內(nèi)容(baselibs)
編解碼的一些內(nèi)容
文件輸出的node(nodes/pvfileoutputnode/Android.mk)
從庫的結(jié)構(gòu)中可以看出,最終生成庫的結(jié)構(gòu)與OpenCore的層次關(guān)系并非完全重合。libopencorecommon.so庫中就包含了底層的OSCL的內(nèi)容、PVMF的框架以及Node和編解碼的工具。
3.libopencoreplayer.so庫的結(jié)構(gòu)
libopencoreplayer.so是用于播放的功能庫,它的編譯控制的文件的路徑為pvplayer/Android.mk,它包含了以下的內(nèi)容:
include $(BUILD_SHARED_LIBRARY)
include $(PV_TOP)//engines/player/Android.mk
include $(PV_TOP)//codecs_v2/audio/aac/dec/util/getactualaacconfig/Android.mk
include $(PV_TOP)//codecs_v2/video/avc_h264/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/aac/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/amr_nb/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/amr_wb/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/common/dec/Android.mk
include $(PV_TOP)//codecs_v2/audio/mp3/dec/Android.mk
include $(PV_TOP)//codecs_v2/utilities/m4v_config_parser/Android.mk
include $(PV_TOP)//codecs_v2/utilities/pv_video_config_parser/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_common/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_queue/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_h264/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_aac/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_amr/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_mp3/Android.mk
include $(PV_TOP)//codecs_v2/omx/factories/omx_m4v_factory/Android.mk
include $(PV_TOP)//codecs_v2/omx/omx_proxy/Android.mk
include $(PV_TOP)//nodes/common/Android.mk
include $(PV_TOP)//pvmi/content_policy_manager/Android.mk
include $(PV_TOP)//pvmi/content_policy_manager/plugins/oma1/passthru/Android.mk
include $(PV_TOP)//pvmi/content_policy_manager/plugins/common/Android.mk
include $(PV_TOP)//pvmi/media_io/pvmiofileoutput/Android.mk
include $(PV_TOP)//fileformats/common/parser/Android.mk
include $(PV_TOP)//fileformats/id3parcom/Android.mk
include $(PV_TOP)//fileformats/rawgsmamr/parser/Android.mk
include $(PV_TOP)//fileformats/mp3/parser/Android.mk
include $(PV_TOP)//fileformats/mp4/parser/Android.mk
include $(PV_TOP)//fileformats/rawaac/parser/Android.mk
include $(PV_TOP)//fileformats/wav/parser/Android.mk
include $(PV_TOP)//nodes/pvaacffparsernode/Android.mk
include $(PV_TOP)//nodes/pvmp3ffparsernode/Android.mk
include $(PV_TOP)//nodes/pvamrffparsernode/Android.mk
include $(PV_TOP)//nodes/pvmediaoutputnode/Android.mk
include $(PV_TOP)//nodes/pvomxvideodecnode/Android.mk
include $(PV_TOP)//nodes/pvomxaudiodecnode/Android.mk
include $(PV_TOP)//nodes/pvwavffparsernode/Android.mk
include $(PV_TOP)//pvmi/recognizer/Android.mk
include $(PV_TOP)//pvmi/recognizer/plugins/pvamrffrecognizer/Android.mk
include $(PV_TOP)//pvmi/recognizer/plugins/pvmp3ffrecognizer/Android.mk
include $(PV_TOP)//pvmi/recognizer/plugins/pvwavffrecognizer/Android.mk
include $(PV_TOP)//engines/common/Android.mk
include $(PV_TOP)//engines/adapters/player/framemetadatautility/Android.mk
include $(PV_TOP)//protocols/rtp_payload_parser/util/Android.mk
include $(PV_TOP)//android/Android.mk
include $(PV_TOP)//android/drm/oma1/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_rtsp/core/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_rtsp/node_registry/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_net_support/core/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_download/core/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_download/node_registry/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_mp4/core/Android.mk
include $(PV_TOP)//tools_v2/build/modules/linux_mp4/node_registry/Android.mk
libopencoreplayer.so中包含了以下內(nèi)容:
一些解碼工具
文件的解析器(mp4)
解碼工具對應(yīng)的Node
player的引擎部分(engines/player/Android.mk)
為Android的player適配器(android/Android.mk)
識別工具(pvmi/recognizer)
編解碼工具中的OpenMax部分(codecs_v2/omx)
對應(yīng)幾個插件Node的注冊
libopencoreplayer.so中的內(nèi)容較多,其中主要為各個文件解析器和解碼器,PVPlayer的核心功能在engines/player/Android.mk當中,而android/Android.mk的內(nèi)容比較特殊,它是在PVPlayer之上構(gòu)建的一個為Android使用的播放器。
4.libopencoreauthor.so庫的結(jié)構(gòu)
libopencoreauthor.so是用于媒體流記錄的功能庫,它的編譯控制的文件的路徑為pvauthor/Android.mk,它包含了以下的內(nèi)容:
include $(BUILD_SHARED_LIBRARY)
include $(PV_TOP)//engines/author/Android.mk
include $(PV_TOP)//codecs_v2/video/m4v_h263/enc/Android.mk
include $(PV_TOP)//codecs_v2/audio/gsm_amr/amr_nb/enc/Android.mk
include $(PV_TOP)//codecs_v2/video/avc_h264/enc/Android.mk
include $(PV_TOP)//fileformats/mp4/composer/Android.mk
include $(PV_TOP)//nodes/pvamrencnode/Android.mk
include $(PV_TOP)//nodes/pvmp4ffcomposernode/Android.mk
include $(PV_TOP)//nodes/pvvideoencnode/Android.mk
include $(PV_TOP)//nodes/pvavcencnode/Android.mk
include $(PV_TOP)//nodes/pvmediainputnode/Android.mk
include $(PV_TOP)//android/author/Android.mk
libopencoreauthor.so中包含了以下內(nèi)容:
一些編碼工具(視頻流H263、H264,音頻流Amr)
文件的組成器(mp4)
編碼工具對應(yīng)的Node
表示媒體輸入的Node(nodes/pvmediainputnode/Android.m)
author的引擎部分(engines/author/Android.mk)
為Android的author適配器(android/author/Android.mk)
libopencoreauthor.so中主要為各個文件編碼器和文件組成器,PVAuthor的核心功能在engines/author/Android.mk當中,而android/author/Android.mk是在PVAuthor之上構(gòu)建的一個為Android使用的媒體記錄器。
5.其他庫
另外的幾個庫的Android.mk文件的路徑如下所示:
網(wǎng)絡(luò)支持庫libopencorenet_support.so:
tools_v2/build/modules/linux_net_support/core/Android.mk
MP4功能實現(xiàn)庫libopencoremp4.so和注冊庫libopencoremp4reg.so:
tools_v2/build/modules/linux_mp4/core/Android.mk
tools_v2/build/modules/linux_mp4/node_registry/Android.mk
RTSP功能實現(xiàn)庫libopencorertsp.so和注冊庫libopencorertspreg.so:
tools_v2/build/modules/linux_rtsp/core/Android.mk
tools_v2/build/modules/linux_rtsp/node_registry/Android.mk
下載功能實現(xiàn)庫libopencoredownload.so和注冊庫libopencoredownloadreg.so:
tools_v2/build/modules/linux_download/core/Android.mk
tools_v2/build/modules/linux_download/node_registry/Android.mk