Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ygsgdbd/v2bar

一个简洁优雅的 macOS 菜单栏应用,为你提供快捷的 V2EX 访问体验
https://github.com/ygsgdbd/v2bar

alamofire macos menubar-app menubarapp swift swiftui tuist v2ex

Last synced: about 1 month ago
JSON representation

一个简洁优雅的 macOS 菜单栏应用,为你提供快捷的 V2EX 访问体验

Awesome Lists containing this project

README

        

# V2Bar 🌟


V2Bar Icon

[![Platform](https://img.shields.io/badge/platform-macOS%2013%2B-brightgreen)](https://github.com/ysgdbd/V2Bar/releases/latest)
[![Swift](https://img.shields.io/badge/Swift-5.9-orange)](https://github.com/ysgdbd/V2Bar)
[![Tuist](https://img.shields.io/badge/Powered%20by-Tuist-blue)](https://tuist.io)
[![Xcode](https://img.shields.io/badge/Xcode-15.0%2B-blue)](https://developer.apple.com/xcode/)
[![SwiftUI](https://img.shields.io/badge/SwiftUI-4.0-blue)](https://developer.apple.com/xcode/swiftui/)

V2Bar 是一个简洁优雅的 macOS 菜单栏应用,为你提供快捷的 V2EX 访问体验。✨

## 预览 👀


V2Bar Preview

## 功能特点 ✨

- 🚀 原生 SwiftUI 开发,超低内存占用
- 🌓 完美支持暗黑模式
- ⚡️ 便捷的菜单栏操作体验
- 👤 快速查看消息和个人信息
- 🔗 一键导航到 V2EX 各版块
- ✍️ 便捷创建和浏题
- 🔒 简单可靠的本地数据存储
- 📖 开源透明,安全可审计

## 为什么选择 V2Bar ✨

- 🚀 **轻量高效**: 原生 SwiftUI 开发,内存占用低至 40MB,安装包仅 8MB
- 🔒 **简单可靠**: 本地数据存储,无需担心隐私泄露
- 👀 **开源透明**: 源代码完全开放,欢迎审计

## 系统要求 🖥

- 📱 macOS 13.0 或更高版本
- 💪 完美支持 Apple Silicon 和 Intel 芯片

## 快速开始 🚀

1. 📥 完成安装后首次启动 V2Bar
2. 🔑 登录 V2EX 网站获取 Personal Access Token
3. 🔒 在 V2Bar 中填入 Token 完成授权
4. ✨ 开始享受便捷的 V2EX 浏览体验

> 💡 提示: Personal Access Token 可以在 V2EX 网站的 [设置页面](https://v2ex.com/settings) 生成。请妥善保管你的 Token。

## 安装方式 📥

### 使用 Homebrew 安装 🍺

```bash
# 添加 V2Bar 的 Homebrew tap 源
brew tap ysgdbd/tap

# 安装 V2Bar 应用
brew install v2bar
```

### 手动安装 📦

1. 🔍 从 [Releases](https://github.com/ysgdbd/V2Bar/releases) 页面下载最新版本的 DMG 文件
2. 💾 打开 DMG 文件并将 V2Bar 拖入 Applications 文件夹
3. 🚀 从 Applications 文件夹启动 V2Bar

## 开发指南 👨‍💻

本项目使用 [Tuist](https://tuist.io) 进行项目管理,开发前请确保安装以下依赖:

```bash
# 安装 Tuist 项目管理工具
brew install tuist
```

克隆项目并生成 Xcode 工程:

```bash
# 克隆 V2Bar 项目代码
git clone https://github.com/ysgdbd/V2Bar.git

# 进入项目目录
cd V2Bar

# 使用 Tuist 生成 Xcode 项目文件
tuist generate
```

### 项目结构 ��

```
V2Bar/
├── Sources/
│ ├── Network/ # 网络请求相关
│ ├── Models/ # 数据模型
│ ├── Views/ # UI 视图
│ ├── ViewModels/ # 视图模型
│ └── Utils/ # 工具类
```

### 技术栈 🛠

- 🎯 [SwiftUI 4.0](https://developer.apple.com/xcode/swiftui/)
- 🌐 [Alamofire](https://github.com/Alamofire/Alamofire)
- 📦 [Tuist](https://tuist.io)
- 🔄 [Combine](https://developer.apple.com/documentation/combine)
- 🛠 [SwiftUIX](https://github.com/SwiftUIX/SwiftUIX)
- ⚡️ [SwifterSwift](https://github.com/SwifterSwift/SwifterSwift)
- 💾 [Defaults](https://github.com/sindresorhus/Defaults)

## 问题反馈 💭

如果你发现了 bug 或有新功能建议,欢迎提交 [Issue](https://github.com/ysgdbd/V2Bar/issues) 进行反馈。我们会认真对待每一条反馈意见! 🙏

## 开源协议 📄

本项目采用 MIT 开源许可证 - 详见 [LICENSE](LICENSE) 文件 ⚖️