Ana Sayfa Keşfet Yardım
Üye Ol Giriş Yap
humuyu
/
xdz-app
1
0
Çatalla 0
Dosyalar Sorunlar 0 Değişiklik İstekleri 0 Wiki
Ağaç: f9ed90cd23
Dallar Biçim İmleri
xdz-app
/
架构说明.html

架构说明.html 30 KB
Geçmiş Ham

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275 
  1. <!DOCTYPE html><html><head>
    2. 

  2.       <title>架构说明</title>
    3. 

  3.       <meta charset="utf-8">
    4. 

  4.       <meta name="viewport" content="width=device-width, initial-scale=1.0">
    5. 

  5.       
    6. 

  6.       <link rel="stylesheet" href="file:////Users/Zhuanz/.cursor/extensions/shd101wyy.markdown-preview-enhanced-0.8.20-universal/crossnote/dependencies/katex/katex.min.css">
    7. 

  7.       
    8. 

  8.       
    9. 

  9.       
    10. 

  10.       
    11. 

  11.       
    12. 

  12.       <style>
    13. 

  13.       code[class*=language-],pre[class*=language-]{color:#333;background:0 0;font-family:Consolas,"Liberation Mono",Menlo,Courier,monospace;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.4;-moz-tab-size:8;-o-tab-size:8;tab-size:8;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*=language-]{padding:.8em;overflow:auto;border-radius:3px;background:#f5f5f5}:not(pre)>code[class*=language-]{padding:.1em;border-radius:.3em;white-space:normal;background:#f5f5f5}.token.blockquote,.token.comment{color:#969896}.token.cdata{color:#183691}.token.doctype,.token.macro.property,.token.punctuation,.token.variable{color:#333}.token.builtin,.token.important,.token.keyword,.token.operator,.token.rule{color:#a71d5d}.token.attr-value,.token.regex,.token.string,.token.url{color:#183691}.token.atrule,.token.boolean,.token.code,.token.command,.token.constant,.token.entity,.token.number,.token.property,.token.symbol{color:#0086b3}.token.prolog,.token.selector,.token.tag{color:#63a35c}.token.attr-name,.token.class,.token.class-name,.token.function,.token.id,.token.namespace,.token.pseudo-class,.token.pseudo-element,.token.url-reference .token.variable{color:#795da3}.token.entity{cursor:help}.token.title,.token.title .token.punctuation{font-weight:700;color:#1d3e81}.token.list{color:#ed6a43}.token.inserted{background-color:#eaffea;color:#55a532}.token.deleted{background-color:#ffecec;color:#bd2c00}.token.bold{font-weight:700}.token.italic{font-style:italic}.language-json .token.property{color:#183691}.language-markup .token.tag .token.punctuation{color:#333}.language-css .token.function,code.language-css{color:#0086b3}.language-yaml .token.atrule{color:#63a35c}code.language-yaml{color:#183691}.language-ruby .token.function{color:#333}.language-markdown .token.url{color:#795da3}.language-makefile .token.symbol{color:#795da3}.language-makefile .token.variable{color:#183691}.language-makefile .token.builtin{color:#0086b3}.language-bash .token.keyword{color:#0086b3}pre[data-line]{position:relative;padding:1em 0 1em 3em}pre[data-line] .line-highlight-wrapper{position:absolute;top:0;left:0;background-color:transparent;display:block;width:100%}pre[data-line] .line-highlight{position:absolute;left:0;right:0;padding:inherit 0;margin-top:1em;background:hsla(24,20%,50%,.08);background:linear-gradient(to right,hsla(24,20%,50%,.1) 70%,hsla(24,20%,50%,0));pointer-events:none;line-height:inherit;white-space:pre}pre[data-line] .line-highlight:before,pre[data-line] .line-highlight[data-end]:after{content:attr(data-start);position:absolute;top:.4em;left:.6em;min-width:1em;padding:0 .5em;background-color:hsla(24,20%,50%,.4);color:#f4f1ef;font:bold 65%/1.5 sans-serif;text-align:center;vertical-align:.3em;border-radius:999px;text-shadow:none;box-shadow:0 1px #fff}pre[data-line] .line-highlight[data-end]:after{content:attr(data-end);top:auto;bottom:.4em}html body{font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif;font-size:16px;line-height:1.6;color:#333;background-color:#fff;overflow:initial;box-sizing:border-box;word-wrap:break-word}html body>:first-child{margin-top:0}html body h1,html body h2,html body h3,html body h4,html body h5,html body h6{line-height:1.2;margin-top:1em;margin-bottom:16px;color:#000}html body h1{font-size:2.25em;font-weight:300;padding-bottom:.3em}html body h2{font-size:1.75em;font-weight:400;padding-bottom:.3em}html body h3{font-size:1.5em;font-weight:500}html body h4{font-size:1.25em;font-weight:600}html body h5{font-size:1.1em;font-weight:600}html body h6{font-size:1em;font-weight:600}html body h1,html body h2,html body h3,html body h4,html body h5{font-weight:600}html body h5{font-size:1em}html body h6{color:#5c5c5c}html body strong{color:#000}html body del{color:#5c5c5c}html body a:not([href]){color:inherit;text-decoration:none}html body a{color:#08c;text-decoration:none}html body a:hover{color:#00a3f5;text-decoration:none}html body img{max-width:100%}html body>p{margin-top:0;margin-bottom:16px;word-wrap:break-word}html body>ol,html body>ul{margin-bottom:16px}html body ol,html body ul{padding-left:2em}html body ol.no-list,html body ul.no-list{padding:0;list-style-type:none}html body ol ol,html body ol ul,html body ul ol,html body ul ul{margin-top:0;margin-bottom:0}html body li{margin-bottom:0}html body li.task-list-item{list-style:none}html body li>p{margin-top:0;margin-bottom:0}html body .task-list-item-checkbox{margin:0 .2em .25em -1.8em;vertical-align:middle}html body .task-list-item-checkbox:hover{cursor:pointer}html body blockquote{margin:16px 0;font-size:inherit;padding:0 15px;color:#5c5c5c;background-color:#f0f0f0;border-left:4px solid #d6d6d6}html body blockquote>:first-child{margin-top:0}html body blockquote>:last-child{margin-bottom:0}html body hr{height:4px;margin:32px 0;background-color:#d6d6d6;border:0 none}html body table{margin:10px 0 15px 0;border-collapse:collapse;border-spacing:0;display:block;width:100%;overflow:auto;word-break:normal;word-break:keep-all}html body table th{font-weight:700;color:#000}html body table td,html body table th{border:1px solid #d6d6d6;padding:6px 13px}html body dl{padding:0}html body dl dt{padding:0;margin-top:16px;font-size:1em;font-style:italic;font-weight:700}html body dl dd{padding:0 16px;margin-bottom:16px}html body code{font-family:Menlo,Monaco,Consolas,'Courier New',monospace;font-size:.85em;color:#000;background-color:#f0f0f0;border-radius:3px;padding:.2em 0}html body code::after,html body code::before{letter-spacing:-.2em;content:'\00a0'}html body pre>code{padding:0;margin:0;word-break:normal;white-space:pre;background:0 0;border:0}html body .highlight{margin-bottom:16px}html body .highlight pre,html body pre{padding:1em;overflow:auto;line-height:1.45;border:#d6d6d6;border-radius:3px}html body .highlight pre{margin-bottom:0;word-break:normal}html body pre code,html body pre tt{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;word-wrap:normal;background-color:transparent;border:0}html body pre code:after,html body pre code:before,html body pre tt:after,html body pre tt:before{content:normal}html body blockquote,html body dl,html body ol,html body p,html body pre,html body ul{margin-top:0;margin-bottom:16px}html body kbd{color:#000;border:1px solid #d6d6d6;border-bottom:2px solid #c7c7c7;padding:2px 4px;background-color:#f0f0f0;border-radius:3px}@media print{html body{background-color:#fff}html body h1,html body h2,html body h3,html body h4,html body h5,html body h6{color:#000;page-break-after:avoid}html body blockquote{color:#5c5c5c}html body pre{page-break-inside:avoid}html body table{display:table}html body img{display:block;max-width:100%;max-height:100%}html body code,html body pre{word-wrap:break-word;white-space:pre}}.markdown-preview{width:100%;height:100%;box-sizing:border-box}.markdown-preview ul{list-style:disc}.markdown-preview ul ul{list-style:circle}.markdown-preview ul ul ul{list-style:square}.markdown-preview ol{list-style:decimal}.markdown-preview ol ol,.markdown-preview ul ol{list-style-type:lower-roman}.markdown-preview ol ol ol,.markdown-preview ol ul ol,.markdown-preview ul ol ol,.markdown-preview ul ul ol{list-style-type:lower-alpha}.markdown-preview .newpage,.markdown-preview .pagebreak{page-break-before:always}.markdown-preview pre.line-numbers{position:relative;padding-left:3.8em;counter-reset:linenumber}.markdown-preview pre.line-numbers>code{position:relative}.markdown-preview pre.line-numbers .line-numbers-rows{position:absolute;pointer-events:none;top:1em;font-size:100%;left:0;width:3em;letter-spacing:-1px;border-right:1px solid #999;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.markdown-preview pre.line-numbers .line-numbers-rows>span{pointer-events:none;display:block;counter-increment:linenumber}.markdown-preview pre.line-numbers .line-numbers-rows>span:before{content:counter(linenumber);color:#999;display:block;padding-right:.8em;text-align:right}.markdown-preview .mathjax-exps .MathJax_Display{text-align:center!important}.markdown-preview:not([data-for=preview]) .code-chunk .code-chunk-btn-group{display:none}.markdown-preview:not([data-for=preview]) .code-chunk .status{display:none}.markdown-preview:not([data-for=preview]) .code-chunk .output-div{margin-bottom:16px}.markdown-preview .md-toc{padding:0}.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link{display:inline;padding:.25rem 0}.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link div,.markdown-preview .md-toc .md-toc-link-wrapper .md-toc-link p{display:inline}.markdown-preview .md-toc .md-toc-link-wrapper.highlighted .md-toc-link{font-weight:800}.scrollbar-style::-webkit-scrollbar{width:8px}.scrollbar-style::-webkit-scrollbar-track{border-radius:10px;background-color:transparent}.scrollbar-style::-webkit-scrollbar-thumb{border-radius:5px;background-color:rgba(150,150,150,.66);border:4px solid rgba(150,150,150,.66);background-clip:content-box}html body[for=html-export]:not([data-presentation-mode]){position:relative;width:100%;height:100%;top:0;left:0;margin:0;padding:0;overflow:auto}html body[for=html-export]:not([data-presentation-mode]) .markdown-preview{position:relative;top:0;min-height:100vh}@media screen and (min-width:914px){html body[for=html-export]:not([data-presentation-mode]) .markdown-preview{padding:2em calc(50% - 457px + 2em)}}@media screen and (max-width:914px){html body[for=html-export]:not([data-presentation-mode]) .markdown-preview{padding:2em}}@media screen and (max-width:450px){html body[for=html-export]:not([data-presentation-mode]) .markdown-preview{font-size:14px!important;padding:1em}}@media print{html body[for=html-export]:not([data-presentation-mode]) #sidebar-toc-btn{display:none}}html body[for=html-export]:not([data-presentation-mode]) #sidebar-toc-btn{position:fixed;bottom:8px;left:8px;font-size:28px;cursor:pointer;color:inherit;z-index:99;width:32px;text-align:center;opacity:.4}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] #sidebar-toc-btn{opacity:1}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc{position:fixed;top:0;left:0;width:300px;height:100%;padding:32px 0 48px 0;font-size:14px;box-shadow:0 0 4px rgba(150,150,150,.33);box-sizing:border-box;overflow:auto;background-color:inherit}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar{width:8px}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar-track{border-radius:10px;background-color:transparent}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc::-webkit-scrollbar-thumb{border-radius:5px;background-color:rgba(150,150,150,.66);border:4px solid rgba(150,150,150,.66);background-clip:content-box}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc a{text-decoration:none}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc{padding:0 16px}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link{display:inline;padding:.25rem 0}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link div,html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper .md-toc-link p{display:inline}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .md-sidebar-toc .md-toc .md-toc-link-wrapper.highlighted .md-toc-link{font-weight:800}html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{left:300px;width:calc(100% - 300px);padding:2em calc(50% - 457px - 300px / 2);margin:0;box-sizing:border-box}@media screen and (max-width:1274px){html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{padding:2em}}@media screen and (max-width:450px){html body[for=html-export]:not([data-presentation-mode])[html-show-sidebar-toc] .markdown-preview{width:100%}}html body[for=html-export]:not([data-presentation-mode]):not([html-show-sidebar-toc]) .markdown-preview{left:50%;transform:translateX(-50%)}html body[for=html-export]:not([data-presentation-mode]):not([html-show-sidebar-toc]) .md-sidebar-toc{display:none}
    14. 

  14. /* Please visit the URL below for more information: */
    15. 

  15. /*   https://shd101wyy.github.io/markdown-preview-enhanced/#/customize-css */
    16. 

  16. 

  17.       </style>
    18. 

  18.       <!-- The content below will be included at the end of the <head> element. --><script type="text/javascript">
    19. 

  19.   document.addEventListener("DOMContentLoaded", function () {
    20. 

  20.     // your code here
    21. 

  21.   });
    22. 

  22. </script></head><body for="html-export">
    23. 

  23.     
    24. 

  24.     
    25. 

  25.       <div class="crossnote markdown-preview  ">
    26. 

  26.       
    27. 

  27. <h1 id="base-core-与-base-common-整体架构说明">base-core 与 base-common 整体架构说明 </h1>
    28. 

  28. <h2 id="-架构概述">📋 架构概述 </h2>
    29. 

  29. <pre data-role="codeBlock" data-info="" class="language-text"><code>业务层（app 模块）
    30. 

  30.     ↓ 依赖
    31. 

  31.     ├── base-common（业务封装层）
    32. 

  32.     └── capability-xxx（能力层）
    33. 

  33.             ↓ 依赖
    34. 

  34.         base-core（基础设施层）
    35. 

  35.             ↑ 依赖
    36. 

  36.         base-common（业务封装层）
    37. 

  37. </code></pre><h3 id="依赖关系">依赖关系 </h3>
    38. 

  38. <ul>
    39. 

  39. <li>✅ <strong>业务层（app 模块）依赖 base-common 和 capability-xxx</strong></li>
    40. 

  40. <li>✅ <strong>能力层（capability 模块）依赖 base-core</strong>（直接依赖，不通过 base-common）</li>
    41. 

  41. <li>✅ <strong>base-common 依赖 base-core</strong></li>
    42. 

  42. </ul>
    43. 

  43. <p><strong>注意：</strong> capability 模块应该直接依赖 base-core，而不是通过 base-common。当前实现中所有 capability 模块都已直接依赖 base-core（符合架构要求）。</p>
    44. 

  44. <h3 id="使用原则">使用原则 </h3>
    45. 

  45. <ul>
    46. 

  46. <li>✅ <strong>能力层（capability 模块）可以调用 base-core</strong></li>
    47. 

  47. <li>✅ <strong>业务层（app 模块）可以调用 base-common 和 capability-xxx</strong></li>
    48. 

  48. <li>❌ <strong>业务层不直接调用 base-core</strong>（通过 base-common 间接使用）</li>
    49. 

  49. </ul>
    50. 

  50. <hr>
    51. 

  51. <h2 id="️-整体代码结构">🏗️ 整体代码结构 </h2>
    52. 

  52. <h3 id="base-core基础设施层">base-core（基础设施层） </h3>
    53. 

  53. <ol>
    54. 

  54. <li><strong>定义接口</strong>：让 capability 模块实现（如 IPushService、IShareService）</li>
    55. 

  55. <li><strong>提供基础能力</strong>：ILog、NetworkManager 等，让所有模块统一使用</li>
    56. 

  56. <li><strong>管理第三方库</strong>：统一版本，避免冲突</li>
    57. 

  57. </ol>
    58. 

  58. <pre data-role="codeBlock" data-info="" class="language-text"><code>xdz_android/base-core/
    59. 

  59. ├── src/main/java/com/narutohuo/xindazhou/core/
    60. 

  60. │   ├── log/
    61. 

  61. │   │   ├── ILog.kt                       ✅ 日志接口定义
    62. 

  62. │   │   └── impl/
    63. 

  63. │   │       ├── TimberLog.kt              ✅ Timber 日志实现（基于 Timber 库）
    64. 

  64. │   │       └── NoOpLog.kt                ✅ 空日志实现（生产环境使用）
    65. 

  65. │   ├── network/
    66. 

  66. │   │   └── NetworkManager.kt             ✅ Retrofit/OkHttp 管理器（单例模式）
    67. 

  67. │   ├── push/
    68. 

  68. │   │   └── IPushService.kt               ✅ 推送服务接口
    69. 

  69. │   ├── share/
    70. 

  70. │   │   ├── IShareService.kt              ✅ 分享服务接口
    71. 

  71. │   │   └── IShareCallback.kt             ✅ 分享回调接口
    72. 

  72. │   ├── storage/
    73. 

  73. │   │   └── IStorage.kt                   ✅ 存储服务接口（键值存储、文件存储、数据库存储）
    74. 

  74. │   └── util/
    75. 

  75. │       └── IUtil.kt                       ✅ 工具类接口（时间处理、字符串处理、加密解密）
    76. 

  76. │                                                                       ⚠️ **使用规则**：只允许纯函数型工具（无副作用、无状态），不允许业务相关、UI相关或依赖Context的工具
    77. 

  77. │   └── wxapi/
    78. 

  78. │       └── WXEntryActivity.kt             ⚠️ 微信分享回调 Activity（微信 SDK 要求，包名必须是应用包名）
    79. 

  79. │                                                                       ⚠️ **架构说明**：虽然文件在 base-core 模块中，但包名使用应用包名（com.narutohuo.xindazhou.wxapi），通过 ARouter 依赖注入获取 IShareCallback 实现，实现解耦
    80. 

  80. └── build.gradle                           ✅ 第三方库管理（Retrofit, OkHttp, Gson, Glide, Coroutines, ARouter, Timber）
    81. 

  81. </code></pre><hr>
    82. 

  82. <h3 id="base-common业务封装层">base-common（业务封装层） </h3>
    83. 

  83. <p><strong>内部概念分层</strong>（虽然是一个物理模块，但内部按职责分层）：</p>
    84. 

  84. <ul>
    85. 

  85. <li><strong>core-facade</strong>（核心封装层）：log、network、storage、util</li>
    86. 

  86. <li><strong>mvvm-support</strong>（MVVM 支持层）：network/ApiServiceFactory、ApiBaseRemoteDataSource、ApiBaseRepository</li>
    87. 

  87. <li><strong>ui-kit</strong>（UI 工具层）：ui、dialog、image、permission、router</li>
    88. 

  88. <li><strong>app-support</strong>（应用支持层）：config、bridge、executor</li>
    89. 

  89. </ul>
    90. 

  90. <pre data-role="codeBlock" data-info="" class="language-text"><code>xdz_android/base-common/
    91. 

  91. ├── src/main/java/com/narutohuo/xindazhou/common/
    92. 

  92. │   ├── bridge/                           # app-support
    93. 

  93. │   │   └── BridgeManager.kt              ✅ H5通信、模块间通信封装（直接实现，无需接口）
    94. 

  94. │   ├── config/                           # app-support
    95. 

  95. │   │   ├── ConfigManager.kt               ✅ 配置管理封装（直接使用 SharedPreferences，无需接口）
    96. 

  96. │   │   └── ServerConfigManager.kt        ⚠️ 特定业务场景（开发测试时的服务器配置，待移到 app 模块）
    97. 

  97. │   ├── executor/                         # app-support
    98. 

  98. │   │   └── ExecutorManager.kt            ✅ 异步任务执行封装（直接使用协程，无需接口）
    99. 

  99. │   ├── log/                              # core-facade
    100. 

  100. │   │   └── LogHelper.kt                  ✅ 封装 ILog，提供日志记录的便捷方法
    101. 

  101. │   ├── storage/                          # core-facade
    102. 

  102. │   │   └── StorageManager.kt              ✅ 封装 IStorage，提供存储管理的便捷方法
    103. 

  103. │   ├── util/                             # core-facade
    104. 

  104. │   │   └── UtilManager.kt                ✅ 封装 IUtil，提供工具方法的便捷调用
    105. 

  105. │   ├── network/                          # core-facade + mvvm-support
    106. 

  106. │   │   ├── NetworkHelper.kt              ✅ 封装 NetworkManager，提供网络初始化和 Token 设置（core-facade）
    107. 

  107. │   │   ├── ApiServiceFactory.kt          ✅ API 服务工厂，统一创建 API 服务实例（mvvm-support）
    108. 

  108. │   │   ├── ApiBaseRemoteDataSource.kt     ✅ 远程数据源基类，封装通用网络请求逻辑（mvvm-support）
    109. 

  109. │   │   ├── ApiBaseRepository.kt          ✅ Repository 基类，提供通用错误处理和数据转换（mvvm-support）
    110. 

  110. │   │   └── ApiResponseParser.kt          ✅ 响应解析器，解析 Retrofit Response（mvvm-support）
    111. 

  111. │   ├── ui/                               # ui-kit
    112. 

  112. │   │   ├── BaseActivity.kt               ⚠️ Activity 基类，支持 ViewBinding、加载状态管理、网络请求封装（单 Activity 架构下不推荐使用）
    113. 

  113. │   │   ├── BaseFragment.kt               ✅ Fragment 基类，支持 ViewBinding、加载状态管理、MVVM 模式、网络请求封装、回调风格异步操作（推荐使用）
    114. 

  114. │   │   ├── ActivityExtensions.kt         ✅ Activity 扩展函数，简化 StateFlow 观察
    115. 

  115. │   │   ├── FragmentExtensions.kt         ✅ Fragment 扩展函数，简化 StateFlow 观察
    116. 

  116. │   │   ├── MessageHelper.kt               ✅ Toast/Snackbar 统一封装，提供便捷的消息提示
    117. 

  117. │   │   └── StatusBarHelper.kt            ✅ 状态栏/导航栏管理，沉浸式状态栏支持
    118. 

  118. │   ├── image/                            # ui-kit
    119. 

  119. │   │   └── ImageLoader.kt                ✅ 图片加载封装（Glide），支持圆形、圆角、占位图
    120. 

  120. │   ├── dialog/                           # ui-kit
    121. 

  121. │   │   └── DialogHelper.kt                ✅ 对话框统一封装，确认、输入、列表选择对话框
    122. 

  122. │   ├── file/                             # ui-kit
    123. 

  123. │   │   └── FilePickerHelper.kt           ✅ 文件选择器封装，支持图片、文件、多文件选择
    124. 

  124. │   ├── camera/                           # ui-kit
    125. 

  125. │   │   └── CameraHelper.kt               ✅ 相机/相册封装，支持拍照、相册选择、图片裁剪
    126. 

  126. │   ├── router/                           # ui-kit
    127. 

  127. │   │   └── RouterHelper.kt               ✅ ARouter 路由封装，统一路由跳转、参数传递
    128. 

  128. │   ├── permission/                       # ui-kit
    129. 

  129. │   │   └── PermissionHelper.kt           ✅ 权限管理封装，权限检查、请求、说明对话框
    130. 

  130. │   └── crash/                            # app-support
    131. 

  131. │       └── CrashHelper.kt                 ✅ 崩溃收集封装，自动捕获崩溃并记录日志
    132. 

  132. └── build.gradle                           ✅ 依赖 base-core
    133. 

  133. </code></pre><hr>
    134. 

  134. <h3 id="capability-xxx能力层">capability-xxx（能力层） </h3>
    135. 

  135. <p><strong>⚠️ 边界定义</strong>：capability 模块必须保持<strong>系统能力/通用能力</strong>的定位，不能包含业务流程。</p>
    136. 

  136. <p><strong>允许的能力类型</strong>：</p>
    137. 

  137. <ul>
    138. 

  138. <li>✅ 系统能力：推送（push）、分享（share）、蓝牙（ble）、NFC（nfc）</li>
    139. 

  139. <li>✅ 通用能力：二维码（qrcode）、文件选择、相机、SocketIO 通信</li>
    140. 

  140. <li>✅ 可被多个 app 复用的能力：任何可以被不同业务场景复用的能力</li>
    141. 

  141. </ul>
    142. 

  142. <pre data-role="codeBlock" data-info="" class="language-text"><code>xdz_android/capability-push/
    143. 

  143. ├── src/main/java/com/narutohuo/xindazhou/push/
    144. 

  144. │   ├── api/
    145. 

  145. │   │   └── PushService.kt                 ✅ 推送服务接口（模块内部，封装极光推送 SDK）
    146. 

  146. │   ├── factory/
    147. 

  147. │   │   └── PushServiceFactory.kt          ✅ 推送服务工厂，提供单例实例
    148. 

  148. │   ├── impl/
    149. 

  149. │   │   └── PushServiceImpl.kt             ✅ 实现 IPushService（base-core 定义）
    150. 

  150. │   ├── model/
    151. 

  151. │   │   ├── PushConfig.kt                  ✅ 推送服务配置（AppKey、AppSecret 等）
    152. 

  152. │   │   └── PushResponse.kt                 ✅ 推送响应模型
    153. 

  153. │   └── receiver/
    154. 

  154. │       └── JPushReceiver.kt                ✅ 极光推送广播接收器（处理推送消息）
    155. 

  155. └── build.gradle                           ✅ 直接依赖 base-core
    156. 

  156. 

  157. xdz_android/capability-share/
    158. 

  158. ├── src/main/java/com/narutohuo/xindazhou/share/
    159. 

  159. │   ├── api/
    160. 

  160. │   │   └── ShareService.kt                 ✅ 分享服务接口（模块内部，封装友盟分享 SDK）
    161. 

  161. │   ├── factory/
    162. 

  162. │   │   └── ShareServiceFactory.kt          ✅ 分享服务工厂，提供单例实例
    163. 

  163. │   ├── impl/
    164. 

  164. │   │   └── ShareServiceImpl.kt             ✅ 实现 IShareService（base-core 定义）
    165. 

  165. │   ├── callback/
    166. 

  166. │   │   └── ShareCallbackImpl.kt            ✅ 分享回调实现（处理友盟 SDK 回调）
    167. 

  167. │   ├── model/
    168. 

  168. │   │   ├── ShareConfig.kt                  ✅ 分享服务配置（各平台 AppKey、AppSecret）
    169. 

  169. │   │   └── ShareResponse.kt                 ✅ 分享响应模型（包含 ShareContent、SharePlatform 等）
    170. 

  170. │   ├── ui/
    171. 

  171. │   │   ├── ShareProxyActivity.kt           ✅ 透明代理 Activity（统一处理分享回调）
    172. 

  172. │   │   └── ShareDialogFragment.kt           ✅ 分享弹窗 Fragment（显示分享平台选择）
    173. 

  173. │   └── douyinapi/
    174. 

  174. │       └── DouYinEntryActivity.kt          ⚠️ 抖音分享回调 Activity（已注释，待 SDK 支持）
    175. 

  175. └── build.gradle                           ✅ 直接依赖 base-core
    176. 

  176. 

  177. xdz_android/capability-ble/
    178. 

  178. ├── src/main/java/com/narutohuo/xindazhou/ble/
    179. 

  179. │   ├── api/
    180. 

  180. │   │   └── BLEService.kt                   ✅ BLE 服务接口（模块内部，封装蓝牙协议）
    181. 

  181. │   ├── factory/
    182. 

  182. │   │   └── BLEServiceFactory.kt            ✅ BLE 服务工厂，创建服务实例
    183. 

  183. │   ├── impl/
    184. 

  184. │   │   └── BLEServiceImpl.kt               ✅ BLE 服务实现（实现 BLEService 接口）
    185. 

  185. │   ├── callback/
    186. 

  186. │   │   └── BLECallback.kt                  ✅ BLE 回调接口定义
    187. 

  187. │   ├── config/
    188. 

  188. │   │   └── BLEConstants.kt                 ✅ BLE 常量定义（UUID、功能码、指令类型等）
    189. 

  189. │   ├── model/
    190. 

  190. │   │   ├── BLEDevice.kt                    ✅ BLE 设备模型
    191. 

  191. │   │   ├── BLEResponse.kt                  ✅ BLE 响应模型
    192. 

  192. │   │   ├── BLECommand.kt                   ✅ BLE 命令模型（完整命令，未分片）
    193. 

  193. │   │   ├── Command.kt                      ✅ 命令数据类（业务层命令封装）
    194. 

  194. │   │   ├── Packet.kt                       ✅ 数据包模型（分片后的单个数据包）
    195. 

  195. │   │   ├── BLEEncryptedData.kt             ✅ BLE 加密数据模型（加密数据区域）
    196. 

  196. │   │   └── FragmentBuffer.kt               ✅ 分片缓冲区（用于重组分片数据包）
    197. 

  197. │   └── util/
    198. 

  198. │       ├── BleScanner.kt                   ✅ BLE 扫描器（扫描蓝牙设备）
    199. 

  199. │       ├── BleConnector.kt                 ✅ BLE 连接器（连接蓝牙设备）
    200. 

  200. │       ├── BlePacketSender.kt             ✅ BLE 数据包发送器（发送分片数据包）
    201. 

  201. │       ├── BLEPacketSplitter.kt            ✅ BLE 数据包分割器（将命令分割成数据包）
    202. 

  202. │       ├── BLEPacketParser.kt              ✅ BLE 数据包解析器（解析接收到的数据包）
    203. 

  203. │       ├── BLEPacketBuilder.kt             ✅ BLE 数据包构建器（构建数据包）
    204. 

  204. │       ├── BLECrypto.kt                    ✅ BLE 加密工具（AES/ECB/PKCS7 加密解密）
    205. 

  205. │       └── BLEExtension.kt                 ✅ BLE 扩展函数（ByteArray、UShort 等扩展）
    206. 

  206. └── build.gradle                           ✅ 直接依赖 base-core
    207. 

  207. 

  208. xdz_android/capability-socketio/
    209. 

  209. ├── src/main/java/com/narutohuo/xindazhou/socketio/
    210. 

  210. │   ├── api/
    211. 

  211. │   │   └── SocketIOService.kt              ✅ SocketIO 服务接口（模块内部）
    212. 

  212. │   ├── factory/
    213. 

  213. │   │   ├── SocketIOServiceFactory.kt       ✅ SocketIO 服务工厂
    214. 

  214. │   │   └── SocketIORepositoryFactory.kt    ✅ SocketIO Repository 工厂
    215. 

  215. │   ├── impl/
    216. 

  216. │   │   └── SocketIOServiceImpl.kt          ✅ SocketIO 服务实现
    217. 

  217. │   ├── repository/
    218. 

  218. │   │   └── SocketIORepository.kt           ✅ SocketIO Repository（封装服务，提供高级 API）
    219. 

  219. │   └── model/
    220. 

  220. │       ├── SocketIOEvent.kt                ✅ SocketIO 事件模型
    221. 

  221. │       └── SocketIOResponse.kt             ✅ SocketIO 响应模型
    222. 

  222. └── build.gradle                           ✅ 直接依赖 base-core
    223. 

  223. 

  224. xdz_android/capability-nfc/
    225. 

  225. ├── src/main/java/com/narutohuo/xindazhou/nfc/
    226. 

  226. │   ├── api/
    227. 

  227. │   │   └── NFCService.kt                   ✅ NFC 服务接口（模块内部）
    228. 

  228. │   ├── impl/
    229. 

  229. │   │   └── NFCServiceImpl.kt               ✅ NFC 服务实现
    230. 

  230. │   └── model/
    231. 

  231. │       └── NFCResponse.kt                  ✅ NFC 响应模型
    232. 

  232. └── build.gradle                           ✅ 直接依赖 base-core
    233. 

  233. 

  234. xdz_android/capability-qrcode/
    235. 

  235. ├── src/main/java/com/narutohuo/xindazhou/qrcode/
    236. 

  236. │   ├── api/
    237. 

  237. │   │   └── QRCodeService.kt                 ✅ 二维码服务接口（模块内部）
    238. 

  238. │   ├── impl/
    239. 

  239. │   │   └── QRCodeServiceImpl.kt             ✅ 二维码服务实现
    240. 

  240. │   └── model/
    241. 

  241. │       └── QRCodeResponse.kt                ✅ 二维码响应模型
    242. 

  242. └── build.gradle                           ✅ 直接依赖 base-core
    243. 

  243. </code></pre><hr>
    244. 

  244. <h3 id="app业务层">app（业务层） </h3>
    245. 

  245. <pre data-role="codeBlock" data-info="" class="language-text"><code>xdz_android/app/
    246. 

  246. ├── src/main/java/com/narutohuo/xindazhou/
    247. 

  247. │   ├── user/
    248. 

  248. │   │   ├── datasource/
    249. 

  249. │   │   │   └── remote/
    250. 

  250. │   │   │       └── AuthRemoteDataSource.kt  ✅ 使用 ApiBaseRemoteDataSource
    251. 

  251. │   │   └── ...
    252. 

  252. │   └── ...
    253. 

  253. └── build.gradle                             ✅ 依赖 base-common 和 capability-xxx
    254. 

  254. </code></pre><hr>
    255. 

  255. <h2 id="-相关文档">📚 相关文档 </h2>
    256. 

  256. <ul>
    257. 

  257. <li><a href="./base-core/README.md">base-core README</a></li>
    258. 

  258. <li><a href="./base-common/README.md">base-common README</a></li>
    259. 

  259. <li><a href="./base-common/src/main/java/com/narutohuo/xindazhou/common/network/%E7%BD%91%E7%BB%9C%E8%AF%B7%E6%B1%82MVVM%E5%B0%81%E8%A3%85%E6%96%B9%E6%A1%88.md">网络请求 MVVM 封装方案</a></li>
    260. 

  260. <li><a href="./base-common/src/main/java/com/narutohuo/xindazhou/common/ui/UI%E5%B1%82%E5%B0%81%E8%A3%85%E6%96%B9%E6%A1%88.md">UI 层封装方案</a></li>
    261. 

  261. <li><a href="./base-common/src/main/java/com/narutohuo/xindazhou/common/%E5%B0%81%E8%A3%85%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md">封装功能使用说明</a></li>
    262. 

  262. <li><a href="./base-common/src/main/java/com/narutohuo/xindazhou/common/base-common%E5%BE%85%E5%B0%81%E8%A3%85%E5%8A%9F%E8%83%BD%E5%88%86%E6%9E%90.md">待封装功能分析</a></li>
    263. 

  263. </ul>
    264. 

  264. 

  265.       </div>
    266. 

  266.       
    267. 

  267.       
    268. 

  268.     
    269. 

  269.     
    270. 

  270.     
    271. 

  271.     
    272. 

  272.     
    273. 

  273.     
    274. 

  274.   
    275. 

  275.     </body></html>
    276.