fix(ios): documentViewer setAnnotation method causing a crash (#12496)

Fixes TIMOB-28360

apidoc/Titanium/UI/iOS/DocumentViewer.yml

@@ -110,6 +110,12 @@ properties:
         the API summary.
     type: String
 
+  - name: annotation
+    summary: Custom property list information for the target file.
+    description: |
+        Use this property to pass information about the document type to the app responsible for opening it.
+    type: [Dictionary, Array, String, Number, Date]
+
 methods:
   - name: hide
     summary: Dismisses the document viewer.

iphone/Classes/TiUIiOSDocumentViewerProxy.m

@@ -37,7 +37,12 @@ - (NSString *)apiName
 
 - (void)setAnnotation:(id)args
 {
-  [self controller].annotation = [args objectAtIndex:0];
+  [self controller].annotation = args;
+}
+
+- (id)annotation
+{
+  return [self controller].annotation;
 }
 
 - (void)show:(id)args

tests/Resources/app.js

@@ -159,6 +159,7 @@ function loadTests() {
 		require('./ti.ui.ios.collisionbehavior.test');
 		require('./ti.ui.ios.feedbackgenerator.test');
 		require('./ti.ui.ios.previewcontext.test');
+		require('./ti.ui.ios.documentviewer.test');
 		require('./ti.ui.ios.splitwindow.test');
 		require('./ti.ui.ios.statusbar.test');
 		require('./ti.ui.ios.stepper.test');

tests/Resources/ti.ui.ios.documentviewer.test.js

@@ -0,0 +1,65 @@
+/*
+ * Appcelerator Titanium Mobile
+ * Copyright (c) 2011-Present by Appcelerator, Inc. All Rights Reserved.
+ * Licensed under the terms of the Apache Public License
+ * Please see the LICENSE included with this distribution for details.
+ */
+/* global OS_VERSION_MAJOR */
+/* eslint-env mocha */
+/* eslint no-unused-expressions: "off" */
+'use strict';
+const should = require('./utilities/assertions');
+const utilities = require('./utilities/utilities');
+
+const isCI = Ti.App.Properties.getBool('isCI', false);
+
+describe.ios('Titanium.UI.iOS',  () => {
+	it('#createDocumentViewer()', () => {
+		should(Ti.UI.iOS.createDocumentViewer).be.a.Function();
+	});
+});
+
+describe.ios('Titanium.UI.iOS.DocumentViewer', () => {
+
+	let documentViewer;
+
+	beforeEach(() => {
+		documentViewer = Ti.UI.iOS.createDocumentViewer({
+			url: 'example.html'
+		});
+	});
+
+	it('.name', function () {
+		// On macOS < 11, it is failing. https://developer.apple.com/forums/thread/125819
+		if (isCI && utilities.isMacOS() && OS_VERSION_MAJOR < 11) {
+			this.skip();
+			return;
+		}
+		documentViewer.annotation = 'annotation';
+		should(documentViewer.name).eql('example.html');
+	});
+
+	it('.annotation', function () {
+		// On macOS < 11, it is failing. https://developer.apple.com/forums/thread/125819
+		if (isCI && utilities.isMacOS() && OS_VERSION_MAJOR < 11) {
+			this.skip();
+			return;
+		}
+
+		documentViewer.annotation = 'annotation';
+		should(documentViewer.annotation).eql('annotation');
+
+		documentViewer.annotation = [ 'annotation1', 'annotation2' ];
+		should(documentViewer.annotation).eql([ 'annotation1', 'annotation2' ]);
+
+		documentViewer.annotation = 1;
+		should(documentViewer.annotation).eql(1);
+
+		const date = Date();
+		documentViewer.annotation = date;
+		should(documentViewer.annotation).eql(date);
+
+		documentViewer.annotation = { key: 'value' };
+		should(documentViewer.annotation).eql({ key: 'value' });
+	});
+});