Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ExistOrLive/GithubClient
Github iOS Client based on Github REST V3 API and GraphQL V4 API
https://github.com/ExistOrLive/GithubClient
apollo-client client github github-api githubclient graphql ios-app objective-c swift
Last synced: about 1 month ago
JSON representation
Github iOS Client based on Github REST V3 API and GraphQL V4 API
- Host: GitHub
- URL: https://github.com/ExistOrLive/GithubClient
- Owner: ExistOrLive
- License: mit
- Created: 2018-12-27T12:19:37.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-05-16T21:57:55.000Z (7 months ago)
- Last Synced: 2024-08-03T17:16:38.084Z (4 months ago)
- Topics: apollo-client, client, github, github-api, githubclient, graphql, ios-app, objective-c, swift
- Language: Swift
- Homepage:
- Size: 182 MB
- Stars: 83
- Watchers: 22
- Forks: 21
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- fucking-open-source-ios-apps - ZLGithubClient
README
# ZLGithubClient
基于 [Github REST V3 API](https://docs.github.com/en/rest) 和 [Github GraphQL V4 API](https://docs.github.com/en/free-pro-team@latest/graphql) 开发的Github iOS客户端
## 安装
- [App Store Release](https://apps.apple.com/app/gorillas/id1498787032)
- [TestFlight Beta](https://testflight.apple.com/join/kCFO5joL)
## 基本功能
1. 搜索开源仓库和开发者
2. 支持浏览每日/周/月开源仓库和开发者趋势榜单
3. 支持浏览开源仓库的基本信息，包括code，commits，issues，pull requests等等
4. 支持fork，watch，star开源仓库
5. 支持浏览登录用户的公开及私有仓库
6. 浏览开发者的基本信息，follow开发者
7. 支持查看follow的开发者和watch的开源repository的最新动态
8. 简单查阅通知
9. 在工作台固定收藏的仓库
10. 在工作台查阅登录用户的issue和pull request
#### Github OAuth login and Access Token login
#### Workboard
#### Notification
#### Trending
#### Profile
#### Search
#### User Info
#### Repository Info
#### View markdown and code
## 开始项目
1. 准备开发环境
- **xcode**
- **ruby**
- **git**
2. 安装**bundle**
```sh
gem install bundle
```
3. 下载项目源码
```sh
git clone https://github.com/ExistOrLive/GithubClient.git
```
4. 切换至 `ZLGithubClient/ZLGithubClient` 目录下，执行 `bundle install`，安装依赖的ruby工具，如 **cocoapods** ，**fastlane** 等
```sh
cd ZLGithubClient/ZLGithubClient
bundle install
```
5. 执行 `bundle exec pod install`
```sh
bundle exec pod install
```
6. 在使用源码前，需要 Github 的账户下创建一个 OAuth Application，具体请参考官方文档 [Creating an OAuth App](https://docs.github.com/en/developers/apps/creating-an-oauth-app); 创建 OAuth Application 后，获得`Client ID` 和 `Client Secret`
7. ZLGithubClient 使用 [Bugly](https://bugly.qq.com/v2/) 和 [Firebase](https://firebase.google.com/) 作为分析工具，因此需要创建对应应用并获取 `Bugly App Id` 和 `GoogleService-Info.plist`
8. 将 `GoogleService-Info.plist` 拷贝到项目对应目录下；创建 `ZLGithubAppKey.h` 文件，提供宏定义 ，并拷贝到对应的目录下
9. 构建工程
## 常见问题解答
[常见问题解答](Document/Troubleshooting/TronbleShooting_Readme.md)
## 贡献者 ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
## 结语
普通的代码千篇一律，优秀的代码万里挑一。开源就如星星之火正在燎原，本项目是开源世界中小小一隅，如果有感兴趣的开发者欢迎加入, 若有意请联系[email protected].
