# getactivity/androidproject architecture

> Architecture diagram of the GitHub repository getactivity/androidproject, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/getactivity/androidproject
- Repository: https://github.com/getactivity/androidproject

## Overview

##### Project type and purpose
- This is a multi-module Android application (“Android 技术中台”) that serves as a boilerplate/architecture mid-platform. It provides a demo app module plus reusable libraries (base, copy, umeng, widget) to speed up new project setup and enforce best practices.

##### File structure
- Top-level Gradle scripts and settings (build.gradle, common.gradle, configs.gradle, settings.gradle) orchestrate a Gradle composite build.
- Modules:
- app – the demo application (com.hjq.demo)
- library/base – core UI and lifecycle abstractions (BaseActivity, BaseFragment, actions)
- library/copy – a utility library for “copy” functionality
- library/umeng – wrappers around Umeng SDK for analytics, login, sharing
- library/widget – custom UI components and layouts (views, widgets)
- Resources under app/src/main/res and each library’s res folder.
- AOP aspects in the demo app: CheckNetAspect, LogAspect, PermissionsAspect, SingleClickAspect.
- HTTP layer in app/src/main/java/com/hjq/demo/http (api interfaces, models, RequestHandler/Server).
- Glide integration under app/src/main/java/com/hjq/demo/http/glide.
- Manager classes for global concerns (ActivityManager, CacheDataManager, ThreadPoolManager, etc.).

##### Insights from README
- The project showcases:
- AOP for cross-cutting concerns (logging, single-click, net checks).
- Encapsulated common code in base classes or libraries.
- Pre-written UI flows (Activities, Fragments, Dialogs) for rapid development.
- Network stack and image loading baked in.
- Emphasizes clean code, resource optimization, compatibility, and agile dev.

##### Detail
- UI: Activities / Fragments / Adapters / Dialogs
- Base Framework: Action classes, BaseActivity, BaseFragment
- Network: HTTP API interfaces, model classes, GlideConfig
- AOP: each aspect as its own component pointing at the layers it intercepts
- Managers: Cache, ThreadPool, DialogManager, etc.
- Essential elements so a new engineer can trace the path of a user interaction:
e.g., Button click → SingleClickAspect → ActivityAction → HTTP call → JSON model → UI update.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation (app/src/main/java/com/hjq/demo/ui)" 
        direction TB
        A1["Activity Classes"]:::module
        A2["Fragment Classes"]:::module
        A3["Adapter Classes"]:::module
        A4["Dialog Classes"]:::module
        A5["Popup Classes"]:::module
        A6["Custom Widget Classes"]:::module
    end

    %% Domain / Action Layer
    subgraph "Domain Services & Actions (app/src/main/java/com/hjq/demo)"
        direction TB
        M1["ActivityManager"]:::manager
        M2["CacheDataManager"]:::manager
        M3["DialogManager"]:::manager
        M4["ThreadPoolManager"]:::manager
        S1["StatusAction"]:::manager
        S2["TitleBarAction"]:::manager
        S3["ToastAction"]:::manager
    end

    %% Data Layer
    subgraph "Data Layer (app/src/main/java/com/hjq/demo/http)"
        direction TB
        D1["API Interfaces"]:::data
        D2["Models & Handlers"]:::data
        D3["Glide Integration"]:::data
    end

    %% Infra / AOP Layer
    subgraph "Cross-cutting AOP (app/src/main/java/com/hjq/demo/aop)"
        direction TB
        O1["CheckNetAspect"]:::aop
        O2["LogAspect"]:::aop
        O3["PermissionsAspect"]:::aop
        O4["SingleClickAspect"]:::aop
    end

    %% Library Modules
    subgraph "Library Modules"
        direction TB
        L1["Core Framework Library\n(library/base/)"]:::module
        L2["Widget UI Library\n(library/widget/)"]:::module
        L3["Copy Utility Library\n(library/copy/)"]:::module
        L4["Umeng Integration Library\n(library/umeng/)"]:::module
    end

    %% External & Platform
    SDK["Android SDK & OS"]:::external
    API["Remote API Server"]:::external
    UMENG["Umeng Service"]:::external

    %% Dependencies & Flows
    A1 -->|"uses"| M1
    A1 -->|"uses"| S2
    A2 -->|"uses"| M2
    A3 -->|"uses"| M3
    A4 -->|"uses"| M3
    A5 -->|"uses"| M3
    A6 -->|"uses"| M4

    A1 -->|"calls"| D1
    D1 -->|"returns data"| A1
    D1 -->|"requests"| API
    D2 -->|"parses JSON"| A1

    A6 -->|"loads images"| D3
    D3 -->|"fetch via"| D1
    D3 -->|"calls OkHttpFetcher"| D1

    O1 -->|"intercepts net calls"| A1
    O2 -->|"logs events"| A1
    O3 -->|"checks perms"| A1
    O4 -->|"prevents double-click"| A1

    A1 -->|"depends on"| L1
    A2 -->|"depends on"| L1
    A3 -->|"depends on"| L2
    A4 -->|"depends on"| L2
    A1 -->|"uses copy util"| L3
    A1 -->|"uses analytics/share"| L4

    D1 -->|"depends on"| L1
    O1 -->|"powered by"| L1

    L4 -->|"calls SDK"| UMENG
    D1 -->|"calls SDK"| SDK

    %% Platform baseline
    SDK -->|"provides"| A1

    %% Click events
    click A1 "https://github.com/getactivity/androidproject/tree/master/app/src/main/java/com/hjq/demo/ui/activity/"
    click A2 "https://github.com/getactivity/androidproject/tree/master/app/src/main/java/com/hjq/demo/ui/fragment/"
    click A3 "https://github.com/getactivity/androidproject/tree/master/app/src/main/java/com/hjq/demo/ui/adapter/"
    click A4 "https://github.com/getactivity/androidproject/tree/master/app/src/main/java/com/hjq/demo/ui/dialog/"
    click A5 "https://github.com/getactivity/androidproject/tree/master/app/src/main/java/com/hjq/demo/ui/popup/"
    click A6 "https://github.com/getactivity/androidproject/tree/master/app/src/main/java/com/hjq/demo/widget/"
    click M1 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/manager/ActivityManager.java"
    click M2 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/manager/CacheDataManager.java"
    click M3 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/manager/DialogManager.java"
    click M4 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/manager/ThreadPoolManager.java"
    click S1 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/action/StatusAction.java"
    click S2 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/action/TitleBarAction.java"
    click S3 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/action/ToastAction.java"
    click D1 "https://github.com/getactivity/androidproject/tree/master/app/src/main/java/com/hjq/demo/http/api/"
    click D2 "https://github.com/getactivity/androidproject/tree/master/app/src/main/java/com/hjq/demo/http/model/"
    click D3 "https://github.com/getactivity/androidproject/tree/master/app/src/main/java/com/hjq/demo/http/glide/"
    click O1 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/aop/CheckNetAspect.java"
    click O2 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/aop/LogAspect.java"
    click O3 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/aop/PermissionsAspect.java"
    click O4 "https://github.com/getactivity/androidproject/blob/master/app/src/main/java/com/hjq/demo/aop/SingleClickAspect.java"
    click L1 "https://github.com/getactivity/androidproject/tree/master/library/base/"
    click L2 "https://github.com/getactivity/androidproject/tree/master/library/widget/"
    click L3 "https://github.com/getactivity/androidproject/tree/master/library/copy/"
    click L4 "https://github.com/getactivity/androidproject/tree/master/library/umeng/"

    %% Styles
    classDef module fill:#D6E4FF,stroke:#3366CC,color:#000;
    classDef manager fill:#E2FFDC,stroke:#2E8B57,color:#000;
    classDef data fill:#FFF0B3,stroke:#CC9900,color:#000;
    classDef aop fill:#FFE5D9,stroke:#FF6600,color:#000;
    classDef external fill:#F0F0F0,stroke:#999999,color:#000;
```
