Skip to content

meilbn/Sandboxer-Objc

Repository files navigation

Sandboxer

Sandboxer

License MIT CocoaPods Language Platform Support

中文介绍

Sandboxer 是用来在 iOS 设备上查看沙盒目录内容的,支持 3D Touch 预览,文件搜索等,方便调试,可以查看一些文件内容,也可以分享出来,方便在电脑上查看。

安装

CocoaPods

  1. 在 Podfile 中添加 pod 'Sandboxer'
  2. 运行 pod installpod update
  3. 导入 <Sandboxer/Sandboxer.h>。

手动安装

  1. 下载 Sandboxer 文件夹内所有源文件。
  2. 将 Sandboxer 文件夹内所有源文件添加(拖入)到你的工程中。
  3. 导入 Sandboxer.h

使用

  • [[Sandboxer shared] trigger]: 打开或关闭
  • systemFilesHidden: 隐藏系统文件(一般是以.开头的文件或目录),默认为 YES
  • homeFileURL: 主目录路径,默认为 Home Directory
  • homeTitle: 主目录标题,默认为 Home
  • extensionHidden: 是否隐藏文件后缀,默认不隐藏。隐藏的话,搜索是不会匹配文件后缀的
  • shareable: 是否可以分享,用来做权限控制,默认可以分享
  • fileDeletable: 是否可以删除文件,用来做权限控制,默认不可以删除
  • directoryDeletable: 是否可以删除文件夹,用来做权限控制,默认不可以删除

版本

  • 1.1.1: 增加了 SPM 的支持
  • 1.1.0: 移除对 UIWebView 的使用,iOS 最低使用版本变更为 iOS 8+
  • 1.0.2: 修复主界面关闭按钮在自定义标题的情况下不显示的问题
  • 1.0.1: 修复了使用 CocoaPods 导入库的时候,找不到资源 Bundle 的问题
  • 1.0.0: 第一版

TODO

  • 快捷关闭,而不用返回到主目录

系统要求

该项目最低支持 iOS 8.0+

许可证

Sandboxer 使用 MIT 许可证,详情见 LICENSE 文件。

English

Sandboxer is use for browse files, file previews and 3D Touch, also search and share file.

Installation

CocoaPods

  1. Add pod 'Sandboxer' to your Podfile.
  2. Run pod install or pod update.
  3. Import <Sandboxer/Sandboxer.h>.

Manually

  1. Download all the files in the Sandboxer subdirectory.
  2. Add the source files to your Xcode project.
  3. Import Sandboxer.h.

Usage

  • [[Sandboxer shared] trigger]: Open or Close
  • systemFilesHidden: Hide system file or directory (Usually begin with .), default is YES
  • homeFileURL: Home directory path URL, default is Home Directory
  • homeTitle: Home directory view controller title, default is Home
  • extensionHidden: Hide file extension, default is NO. If YES, will not match the file extension when searching
  • shareable: If can share file, use for permission control, default is YES
  • fileDeletable: If can delete file, use for permission control, default is NO
  • directoryDeletable: If can delete directory, use for permission control, default is NO

Version

  • 1.1.0: Added SPM support.
  • 1.1.0: Removed UIWebView,lowest support iOS version change to iOS 8+
  • 1.0.2: Fixed close button in the home dosen't display when setting custom title
  • 1.0.1: Fixed couldn't find resources bundle issue when using CocoaPods to import library.
  • 1.0.0: First release.

TODO

  • Quick close without returning to the home directory

Requirements

This library requires iOS 8.0+

License

Sandboxer is provided under the MIT license. See LICENSE file for details.