# BKDevMenu

**Repository Path**: luzizheng/BKDevMenu

## Basic Information

- **Project Name**: BKDevMenu
- **Description**: an iOS App dev menu always on top window
- **Primary Language**: Objective-C
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-02-09
- **Last Updated**: 2022-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BKDevMenu
iOS App调试菜单入口 (始终在app的最上层的一个dev按钮)

[测试同学点这里！账号快速登陆使用指南！](guideto:QuickLoginGuide)

#### 自带功能有：

1. 查看app控制台
2. 查看app沙盒文件浏览器；
3. 全局快速切换环境按钮（UISegmentContrller）；
4. 测试页面快速预览入口；
5. 快速登陆模块（配置快速登陆名单）

![](guide01.png)

## Installation:

```ruby
pod 'BKDevMenu'
```



仅在DEBUG模式下导入(不增加生产包大小)

```ruby
pod 'BKDevMenu', :configurations => ['Debug']
```



## Usage:

* #### App启动：

```objective-c
#import "BKDevMenuManager.h"
[BKDevMenuManager shareManager].enable = YES;
[[BKDevMenuManager shareManager] setupMenu:[DemoMenu new]];
```

- #### 添加测试入口

  - 创建一个类继承BKBaseDevMenu

     ```objective-c
     @interface DemoMenu : BKBaseDevMenu
     
     @end
     ```

     

  - .m文件中引入并添加一些测试页面

     ```objective-c
     #import "BKDevMenu.h"
     
     #import "TestVC1.h"
     #import "TestVC2.h"
     #import "TestVC3.h"
     
     @implementation BKDevMenu
     - (void)addingTestPages
     {
         [self addTestPageWithTitle:@"测试页面1" andAction:^(UINavigationController * _Nonnull nav) {
             [nav pushViewController:[TestVC1 new] animated:YES];
         }];
         [self addTestPageWithTitle:@"测试页面2" andAction:^(UINavigationController * _Nonnull nav) {
             [nav pushViewController:[TestVC2 new] animated:YES];
         }];
         [self addTestPageWithTitle:@"测试页面3" andAction:^(UINavigationController * _Nonnull nav) {
             [nav pushViewController:[TestVC3 new] animated:YES];
         }];
         
     }
     @end
     ```

     
  
     
  
- #### 额外自带能力(在addingTestPages方法内添加)

  - 添加全局切换状态模块

    ```objective-c
    [self addTestSegmentWithTitle:@"切换服务器" segments:@[@"测试",@"生产",@"仿真"] defaultIndex:^NSInteger{
            return 1;
        } segAction:^(NSInteger index, UINavigationController * _Nonnull nav) {
            // 根据index自行实现切换逻辑
    }];
    ```

    

  - 添加沙盒文件浏览器模块

    ```objective-c
    [self addSandBoxViewer:nil];
    ```

    

  - 添加app内置控制台模块

    ```objective-c
    [self addAppConsole];
    ```

    

  - 添加快速登陆模块

    ```objective-c
    [self addQuickLoginUserListWithLoginAction:^(UINavigationController * _Nonnull nav, BKDevQuickLoginUserModel * _Nonnull user) {
            // 具体实现登陆的逻辑
        }];
    ```



## 反馈：

[MailTo Luzz](mailto:gtxyb@163.com)