README.md

JhtDocViewer

Function Description

1. 文档查看器（Word && Excel && PDF && Rft || Network && Local || self && other App）
2. 文件共享 && 查看 (Network && Local)

how to use

1. podfile

platform:ios, '8.0'

target '*****' do

pod 'JhtDocViewer'
        
end

2. 相关参数配置

a. JhtLoadDocViewParamModel：文本加载 View 配置Model

JhtLoadDocView内部相关属性的修改可通过修改此model实现

b. JhtDocFileOperations：文件操作类

文件保存 && 清理等方法

c. JhtShowDumpingViewParamModel：下滑提示框配置参数model

用于设置提示框中的 文字的大小，颜色，位置，背景图，是否包含警示小图标等参数

d. JhtFileModel：下载文档的Model

用于设置文件ID，文件名，绝对路径（本地文件），文件大小等参数

• 文本类 default值 亦可通过修改 JhtDocViewer_Default.plist 相应键值对进行修改

3. DocListViewController：文档列表

tableView的数据源是一个装有model的数组，model根据属性fileAbsolutePath（本地绝对路径），判断是否需要下载	

4. LoadDocViewController：文档详情VC，内部使用JhtLoadDocView

5. JhtLoadDocView：文本加载 View

a. 如果不需要下载，通过webView直接显示

b. 需要下载，则通过JhtDownloadRequest函数中的类方法进行下载，暂停等操作（注意：JhtFileModel属性：fileSize，应写成这种式“KB,MB,GB,Bytes”，为了计算手机剩余内存，关系是否能下载成功

c. 资源共享

《JhtDocViewer》文件用”其他应用“打开

“其他应用”文件用《JhtDocViewer》打开
  

d. 无网络弹框

     

• 具体使用详见demo

needed to pay attention

1. 如果我们在iOS9下直接进行HTTP请求是会收到如下错误提示

App Transport Security has blocked a cleartext HTTP (http://) resource load since it is insecure. Temporary exceptions can be configured via your app's Info.plist file.

系统会告诉我们不能直接使用HTTP进行请求，需要在Info.plist新增一段用于控制ATS的配置

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

即：

2. 如果想共享自己app的文档查看功能，需在info.plist 中添加如下信息

<key>CFBundleDocumentTypes</key>
	<array>
		<dict>
			<key>CFBundleTypeIconFiles</key>
			<array>
				<string>MySmallIcon.png</string>
				<string>MyLargeIcon.png</string>
			</array>
			<key>CFBundleTypeName</key>
			<string>My File Format</string>
			<key>LSHandlerRank</key>
			<string>Owner</string>
			<key>LSItemContentTypes</key>
			<array>
				<string>com.microsoft.powerpoint.ppt</string>
				<string>public.item</string>
				<string>com.microsoft.word.doc</string>
				<string>com.adobe.pdf</string>
				<string>com.microsoft.excel.xls</string>
				<string>public.image</string>
				<string>public.content</string>
				<string>public.composite-content</string>
				<string>public.archive</string>
				<string>public.audio</string>
				<string>public.movie</string>
				<string>public.text</string>
				<string>public.data</string>
			</array>
		</dict>
	</array>

属性说明：

• CFBundleTypeName：文档的类型名称
• LSHandlerRank：这里指是否拥有子文档
  

3. info.plist 中，对应Localization native development region键值 加入Chinese

4. 在第三方调用我们的APP后，会调用如下方法

- (BOOL)application:(UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<NSString *,id> *)options {
    if (options) {
        NSString *str = [NSString stringWithFormat:@"\n发送请求的应用程序的 Bundle ID：%@\n\n文件的NSURL：%@", options[UIApplicationOpenURLOptionsSourceApplicationKey], url];
        NSLog(@"%@", str);
        
        if (self.window && url) {
            // 根据“其他应用” 用“本应用”打开，通过url，进入列表页
            [self pushDocListViewControllerWithUrl:url];
        }
    }
    return YES;
}


#pragma mark ApplicationDelegate Method
/** 根据“其他应用” 用“本应用”打开，通过url，进入列表页 */
- (void)pushDocListViewControllerWithUrl:(NSURL *)url {
    // 根据“其他应用” 用“本应用”打开，通过要打开的url，获得本地地址
    NSString *appFilePath = [[JhtDocFileOperations sharedInstance] findLocalPathFromAppLicationOpenUrl:url];
    // 跳转页面
    DocListViewController *doc = [[DocListViewController alloc] init];
    doc.appFilePath = appFilePath;
    [_nav pushViewController:doc animated:YES];
}

5. 库文件

系统库：WebKit.framework
三方库：AFNetworking3.x：自行添加

     

Remind

• ARC
• iOS >= 8.0
• iPhone \ iPad
• Xcode version >= 9.0

Hope

• If you find bug when used，Hope you can Issues me，Thank you or try to download the latest code of this framework to see the BUG has been fixed or not
• If you find the function is not enough when used，Hope you can Issues me，I very much to add more useful function to this framework ，Thank you !