Skip to content

Latest commit

 

History

History
148 lines (114 loc) · 6.12 KB

README.md

File metadata and controls

148 lines (114 loc) · 6.12 KB
Raw

App-Architecture

简介

App-Architecture是一个关于移动应用一整套架构的解决方案开源项目。主要目的是整合流行开发模式结合自己本人的工作经验形成的一整套App快速开发解决方案。本套解决方案的app工程和simple工程主要基于Android实现。framework工程实现了主要架构，主要目的是抛开平台相关性。

项目主要包括两大部分

Framework层

依托以java级别，主要提供底层API框架接口，提供一种编程思想同时从平台中剥离出来

  1. CacheSystem 缓存系统
  2. Configuration 基础应用配置
  3. Context 接管App层级上下文
  4. NetworkInteractor 网络模块，主要负责网络检测以及网络请求
  5. FileSystem 文件系统
  6. Database 数据库 (参考realm-java)
  7. Theme 主题
  8. Scene 场景功能
  9. ModelFactory 业务工厂（实现IModel功能的所有业务操作类）
  10. PluginManager 插件化系统，主要对可扩展类的考虑。在一些特殊的系统中，可能存在ChildSystem级别的系统功能。需要继承PluginChildSystem来实现
  11. LogCollector 日志收集系统，针对所有日志做处理（开关，打印，本地保持，上传server等功能）
  12. BackgroundExecutor 定制线程池
  13. LocalBroadcastManager 子系统通信机制管理
  14. ExceptionHandler 异常处理

App层

依赖于Framework Library。实现基于Android平台下的一系列接口

  1. 主要接管Activity和Fragment中的架构，采用了MVVM的方式来解放UI(最近受到IOS的MVC架构所启发，Android的View概念被弱化，Activity和Fragment被强化导致很多同学认为这两者就是UI上的事情。其实不是这样，Fragment应该类似于IOS中的UIViewController才对。因此本框架通过UIView来强化Android的UI概念。用Fragment来做为UIViewController。)
  2. App全局只有一个入口启动MainActivity同时也是唯一的一个Activity。MainActivity继承了FragmentContainerActivity，因此他是Fragment容器(页面跳转采用FragmentScheduler提供的方法，目前主要考虑单一Activity多Fragment对复杂页面管理问题，引用了通过schema跳转到单独Activity+Fragment的方式来增加多种跳转实现的支持)
  3. 所有页面都是Fragment实现，包括启动页面。主要利用support.v4包的FragmentManager来管理整个Fragment堆栈实现页面切换功能
  4. 页面请求都采用线程池执行Task的方式来完成，回调使用了Rxjava的订阅/消费的观察者模式完成
  5. Model设计初衷是为了处理各种业务，Model和View的关系是多对多的关系。Model不依赖View，但是依托于View。

架构图

架构图

工程应用

Simple工程

Simple工程数据主要参考philm工程

实际项目应用

完整应用GithubAndroidClient

注

由于整个工程项目开发是一个很耗时的迭代过程，所以有考虑不全面的地方希望引用同学继续补充(贡献分支branch_contributors)。在补充过程中尽量通知到作者本人。希望有兴趣的同学加入进来，把这个工程完善得更好。

依赖注入和事件总线思想在本项目里是排斥的，原因很简单，不仅仅从性能方面的考虑,同时：

  1. 依赖让代码指向混乱同时也给开发者造成结构的不清晰
  2. 事件总线思想很容易造成滥用的现象，就像广播一样，没有目的的注册和广播很容易导致内存泄露发生

Quality

  1. CheckStyle
  2. Findbugs
  3. Pmd
  4. Lint

(目前工程代码质量未严格把关，后续打算完善这一步)

第三方依赖

  1. 基础库guava
  2. 网络库okhttp3
  3. 数据解码库gson
  4. 图片库fresco
  5. 事件传递机制的Rxjava2
  6. 内存泄露检测库leakcanary

应用

Gradle-SNAPSHOT
  repositories {
        maven {
            url "https://oss.sonatype.org/content/repositories/snapshots/"
        }
    }
   
   compile "com.github.frodoking:app-architecture-android:1.2.15-SNAPSHOT"
Gradle-RELEASE
repositories {
        mavenCentral()
    }
compile "com.github.frodoking:app-architecture-android:1.5"
  1. implement ApplicationDelegation in MainApplication
  2. override RedirectActivity in manifest.xml if you want to replace direct scheme
<activity
    android:name="com.frodo.app.android.ui.activity.RedirectActivity"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:label="redirect"
    tools:node="merge" >
    <intent-filter tools:node="replace">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data
            android:scheme="{custom scheme}"
            android:host="redirect"
            tools:replace="scheme"/>
    </intent-filter>
    <meta-data
        android:name="REDIRECT_SCHEME_KEY"
        android:value="{custom scheme}"
        tools:replace="value"/>
</activity>
Proguard
-keep public class com.frodo.app.android.core.network.integration.okhttp.OkHttpModule
-keep public class * extends com.frodo.app.framework.controller.AbstractModel {
    public <init>(com.frodo.app.framework.controller.MainController);
}

关于作者(frodoking)

#License Copyright 2015 Frodo.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.