Adding Readme

.gitignore

@@ -1,61 +0,0 @@
-# Xcode specific
-.DS_Store
-*.xcuserstate
-*.xcscmblueprint
-*.swp
-*.mode1v3
-*.mode2v3
-*.perspectivev3
-
-# User-specific settings
-xcuserdata/
-*.xcworkspace/xcuserdata/
-
-# Xcode build
-build/
-*.ipa
-*.dSYM.zip
-*.dSYM
-
-# CocoaPods
-Pods/
-Podfile.lock
-
-# Carthage
-Carthage/Build/
-
-# Swift Package Manager
-.build/
-DerivedData/
-SourcePackages/
-Package.resolved
-
-# Fastlane
-fastlane/report.xml
-fastlane/Preview.html
-fastlane/screenshots
-fastlane/test_output
-
-# Generated files
-*.moved-aside
-*.hmap
-*.ipa
-*.xcuserdatad
-*.localized
-*.xcworkspacedata
-
-# Temporary and System files
-*.tmp
-*.log
-*.swp
-*.lock
-*.lock/
-*.lck
-*.sync
-
-# Playgrounds
-timeline.xctimeline
-playground.xcworkspace
-
-# SwiftPM
-.swiftpm/

.gitmodules

@@ -1,3 +0,0 @@
-[submodule "ResearchKit"]
-	path = ResearchKit
-	url = https://github.com/ResearchKit/ResearchKit.git

RK-Setup-Git.xcodeproj/project.pbxproj

@@ -13,73 +13,8 @@
 		7EE7BFA32CB8F25B0000161D /* Base in Resources */ = {isa = PBXBuildFile; fileRef = 7EE7BFA22CB8F25B0000161D /* Base */; };
 		7EE7BFA52CB8F25C0000161D /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 7EE7BFA42CB8F25C0000161D /* Assets.xcassets */; };
 		7EE7BFA82CB8F25C0000161D /* Base in Resources */ = {isa = PBXBuildFile; fileRef = 7EE7BFA72CB8F25C0000161D /* Base */; };
-		7EE7BFF62CB8FA1C0000161D /* SurveyTask.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7EE7BFF52CB8FA1C0000161D /* SurveyTask.swift */; };
-		7EE7C01F2CB9E9D90000161D /* ResearchKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 7EE7C0182CB9E60E0000161D /* ResearchKit.framework */; };
-		7EE7C0202CB9E9D90000161D /* ResearchKit.framework in Embed Frameworks */ = {isa = PBXBuildFile; fileRef = 7EE7C0182CB9E60E0000161D /* ResearchKit.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
-		7EE7C0212CB9E9D90000161D /* ResearchKitUI.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 7EE7C01C2CB9E60E0000161D /* ResearchKitUI.framework */; };
-		7EE7C0222CB9E9D90000161D /* ResearchKitUI.framework in Embed Frameworks */ = {isa = PBXBuildFile; fileRef = 7EE7C01C2CB9E60E0000161D /* ResearchKitUI.framework */; settings = {ATTRIBUTES = (CodeSignOnCopy, RemoveHeadersOnCopy, ); }; };
 /* End PBXBuildFile section */
 
-/* Begin PBXContainerItemProxy section */
-		7EE7C0172CB9E60E0000161D /* PBXContainerItemProxy */ = {
-			isa = PBXContainerItemProxy;
-			containerPortal = 7EE7C0102CB9E60E0000161D /* ResearchKit.xcodeproj */;
-			proxyType = 2;
-			remoteGlobalIDString = B183A5951A8535D100C76870;
-			remoteInfo = ResearchKit;
-		};
-		7EE7C0192CB9E60E0000161D /* PBXContainerItemProxy */ = {
-			isa = PBXContainerItemProxy;
-			containerPortal = 7EE7C0102CB9E60E0000161D /* ResearchKit.xcodeproj */;
-			proxyType = 2;
-			remoteGlobalIDString = 86CC8E9A1AC09332001CCD89;
-			remoteInfo = ResearchKitTests;
-		};
-		7EE7C01B2CB9E60E0000161D /* PBXContainerItemProxy */ = {
-			isa = PBXContainerItemProxy;
-			containerPortal = 7EE7C0102CB9E60E0000161D /* ResearchKit.xcodeproj */;
-			proxyType = 2;
-			remoteGlobalIDString = CA1C7A5A288B0C68004DAB3A;
-			remoteInfo = "ResearchKitUI (iOS)";
-		};
-		7EE7C01D2CB9E60E0000161D /* PBXContainerItemProxy */ = {
-			isa = PBXContainerItemProxy;
-			containerPortal = 7EE7C0102CB9E60E0000161D /* ResearchKit.xcodeproj */;
-			proxyType = 2;
-			remoteGlobalIDString = CAD08967289DD747007B2A98;
-			remoteInfo = ResearchKitActiveTask;
-		};
-		7EE7C0232CB9EC410000161D /* PBXContainerItemProxy */ = {
-			isa = PBXContainerItemProxy;
-			containerPortal = 7EE7C0102CB9E60E0000161D /* ResearchKit.xcodeproj */;
-			proxyType = 1;
-			remoteGlobalIDString = B183A4731A8535D100C76870;
-			remoteInfo = ResearchKit;
-		};
-		7EE7C0252CB9EC410000161D /* PBXContainerItemProxy */ = {
-			isa = PBXContainerItemProxy;
-			containerPortal = 7EE7C0102CB9E60E0000161D /* ResearchKit.xcodeproj */;
-			proxyType = 1;
-			remoteGlobalIDString = CA1C7A40288B0C68004DAB3A;
-			remoteInfo = "ResearchKitUI (iOS)";
-		};
-/* End PBXContainerItemProxy section */
-
-/* Begin PBXCopyFilesBuildPhase section */
-		7EE7C0082CB8FF010000161D /* Embed Frameworks */ = {
-			isa = PBXCopyFilesBuildPhase;
-			buildActionMask = 2147483647;
-			dstPath = "";
-			dstSubfolderSpec = 10;
-			files = (
-				7EE7C0222CB9E9D90000161D /* ResearchKitUI.framework in Embed Frameworks */,
-				7EE7C0202CB9E9D90000161D /* ResearchKit.framework in Embed Frameworks */,
-			);
-			name = "Embed Frameworks";
-			runOnlyForDeploymentPostprocessing = 0;
-		};
-/* End PBXCopyFilesBuildPhase section */
-
 /* Begin PBXFileReference section */
 		7EE7BF982CB8F25B0000161D /* RK-Setup-Git.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "RK-Setup-Git.app"; sourceTree = BUILT_PRODUCTS_DIR; };
 		7EE7BF9B2CB8F25B0000161D /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
@@ -89,8 +24,6 @@
 		7EE7BFA42CB8F25C0000161D /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
 		7EE7BFA72CB8F25C0000161D /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = "<group>"; };
 		7EE7BFA92CB8F25C0000161D /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
-		7EE7BFF52CB8FA1C0000161D /* SurveyTask.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SurveyTask.swift; sourceTree = "<group>"; };
-		7EE7C0102CB9E60E0000161D /* ResearchKit.xcodeproj */ = {isa = PBXFileReference; lastKnownFileType = "wrapper.pb-project"; name = ResearchKit.xcodeproj; path = ResearchKit/ResearchKit.xcodeproj; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -98,8 +31,6 @@
 			isa = PBXFrameworksBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				7EE7C0212CB9E9D90000161D /* ResearchKitUI.framework in Frameworks */,
-				7EE7C01F2CB9E9D90000161D /* ResearchKit.framework in Frameworks */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -109,10 +40,8 @@
 		7EE7BF8F2CB8F25B0000161D = {
 			isa = PBXGroup;
 			children = (
-				7EE7C0102CB9E60E0000161D /* ResearchKit.xcodeproj */,
 				7EE7BF9A2CB8F25B0000161D /* RK-Setup-Git */,
 				7EE7BF992CB8F25B0000161D /* Products */,
-				7EE7BFBE2CB8F7520000161D /* Frameworks */,
 			);
 			sourceTree = "<group>";
 		};
@@ -134,29 +63,10 @@
 				7EE7BFA42CB8F25C0000161D /* Assets.xcassets */,
 				7EE7BFA62CB8F25C0000161D /* LaunchScreen.storyboard */,
 				7EE7BFA92CB8F25C0000161D /* Info.plist */,
-				7EE7BFF52CB8FA1C0000161D /* SurveyTask.swift */,
 			);
 			path = "RK-Setup-Git";
 			sourceTree = "<group>";
 		};
-		7EE7BFBE2CB8F7520000161D /* Frameworks */ = {
-			isa = PBXGroup;
-			children = (
-			);
-			name = Frameworks;
-			sourceTree = "<group>";
-		};
-		7EE7C0112CB9E60E0000161D /* Products */ = {
-			isa = PBXGroup;
-			children = (
-				7EE7C0182CB9E60E0000161D /* ResearchKit.framework */,
-				7EE7C01A2CB9E60E0000161D /* ResearchKitTests.xctest */,
-				7EE7C01C2CB9E60E0000161D /* ResearchKitUI.framework */,
-				7EE7C01E2CB9E60E0000161D /* ResearchKitActiveTask.framework */,
-			);
-			name = Products;
-			sourceTree = "<group>";
-		};
 /* End PBXGroup section */
 
 /* Begin PBXNativeTarget section */
@@ -167,13 +77,10 @@
 				7EE7BF942CB8F25B0000161D /* Sources */,
 				7EE7BF952CB8F25B0000161D /* Frameworks */,
 				7EE7BF962CB8F25B0000161D /* Resources */,
-				7EE7C0082CB8FF010000161D /* Embed Frameworks */,
 			);
 			buildRules = (
 			);
 			dependencies = (
-				7EE7C0242CB9EC410000161D /* PBXTargetDependency */,
-				7EE7C0262CB9EC410000161D /* PBXTargetDependency */,
 			);
 			name = "RK-Setup-Git";
 			productName = "RK-Setup-Git";
@@ -206,12 +113,6 @@
 			mainGroup = 7EE7BF8F2CB8F25B0000161D;
 			productRefGroup = 7EE7BF992CB8F25B0000161D /* Products */;
 			projectDirPath = "";
-			projectReferences = (
-				{
-					ProductGroup = 7EE7C0112CB9E60E0000161D /* Products */;
-					ProjectRef = 7EE7C0102CB9E60E0000161D /* ResearchKit.xcodeproj */;
-				},
-			);
 			projectRoot = "";
 			targets = (
 				7EE7BF972CB8F25B0000161D /* RK-Setup-Git */,
@@ -219,37 +120,6 @@
 		};
 /* End PBXProject section */
 
-/* Begin PBXReferenceProxy section */
-		7EE7C0182CB9E60E0000161D /* ResearchKit.framework */ = {
-			isa = PBXReferenceProxy;
-			fileType = wrapper.framework;
-			path = ResearchKit.framework;
-			remoteRef = 7EE7C0172CB9E60E0000161D /* PBXContainerItemProxy */;
-			sourceTree = BUILT_PRODUCTS_DIR;
-		};
-		7EE7C01A2CB9E60E0000161D /* ResearchKitTests.xctest */ = {
-			isa = PBXReferenceProxy;
-			fileType = wrapper.cfbundle;
-			path = ResearchKitTests.xctest;
-			remoteRef = 7EE7C0192CB9E60E0000161D /* PBXContainerItemProxy */;
-			sourceTree = BUILT_PRODUCTS_DIR;
-		};
-		7EE7C01C2CB9E60E0000161D /* ResearchKitUI.framework */ = {
-			isa = PBXReferenceProxy;
-			fileType = wrapper.framework;
-			path = ResearchKitUI.framework;
-			remoteRef = 7EE7C01B2CB9E60E0000161D /* PBXContainerItemProxy */;
-			sourceTree = BUILT_PRODUCTS_DIR;
-		};
-		7EE7C01E2CB9E60E0000161D /* ResearchKitActiveTask.framework */ = {
-			isa = PBXReferenceProxy;
-			fileType = wrapper.framework;
-			path = ResearchKitActiveTask.framework;
-			remoteRef = 7EE7C01D2CB9E60E0000161D /* PBXContainerItemProxy */;
-			sourceTree = BUILT_PRODUCTS_DIR;
-		};
-/* End PBXReferenceProxy section */
-
 /* Begin PBXResourcesBuildPhase section */
 		7EE7BF962CB8F25B0000161D /* Resources */ = {
 			isa = PBXResourcesBuildPhase;
@@ -268,7 +138,6 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				7EE7BFF62CB8FA1C0000161D /* SurveyTask.swift in Sources */,
 				7EE7BFA02CB8F25B0000161D /* ViewController.swift in Sources */,
 				7EE7BF9C2CB8F25B0000161D /* AppDelegate.swift in Sources */,
 				7EE7BF9E2CB8F25B0000161D /* SceneDelegate.swift in Sources */,
@@ -277,19 +146,6 @@
 		};
 /* End PBXSourcesBuildPhase section */
 
-/* Begin PBXTargetDependency section */
-		7EE7C0242CB9EC410000161D /* PBXTargetDependency */ = {
-			isa = PBXTargetDependency;
-			name = ResearchKit;
-			targetProxy = 7EE7C0232CB9EC410000161D /* PBXContainerItemProxy */;
-		};
-		7EE7C0262CB9EC410000161D /* PBXTargetDependency */ = {
-			isa = PBXTargetDependency;
-			name = "ResearchKitUI (iOS)";
-			targetProxy = 7EE7C0252CB9EC410000161D /* PBXContainerItemProxy */;
-		};
-/* End PBXTargetDependency section */
-
 /* Begin PBXVariantGroup section */
 		7EE7BFA12CB8F25B0000161D /* Main.storyboard */ = {
 			isa = PBXVariantGroup;
@@ -347,7 +203,7 @@
 				DEBUG_INFORMATION_FORMAT = dwarf;
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
 				ENABLE_TESTABILITY = YES;
-				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				ENABLE_USER_SCRIPT_SANDBOXING = YES;
 				GCC_C_LANGUAGE_STANDARD = gnu17;
 				GCC_DYNAMIC_NO_PIC = NO;
 				GCC_NO_COMMON_BLOCKS = YES;
@@ -410,7 +266,7 @@
 				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
 				ENABLE_NS_ASSERTIONS = NO;
 				ENABLE_STRICT_OBJC_MSGSEND = YES;
-				ENABLE_USER_SCRIPT_SANDBOXING = NO;
+				ENABLE_USER_SCRIPT_SANDBOXING = YES;
 				GCC_C_LANGUAGE_STANDARD = gnu17;
 				GCC_NO_COMMON_BLOCKS = YES;
 				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;

RK-Setup-Git.xcodeproj/xcuserdata/gmarx.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -7,7 +7,7 @@
 		<key>RK-Setup-Git.xcscheme_^#shared#^_</key>
 		<dict>
 			<key>orderHint</key>
-			<integer>3</integer>
+			<integer>0</integer>
 		</dict>
 	</dict>
 </dict>

RK-Setup-Git/Base.lproj/Main.storyboard

@@ -1,46 +1,24 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="32700.99.1234" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="BYZ-38-t0r">
-    <device id="retina6_12" orientation="portrait" appearance="light"/>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="13122.16" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="BYZ-38-t0r">
     <dependencies>
-        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="22685"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="13104.12"/>
         <capability name="Safe area layout guides" minToolsVersion="9.0"/>
-        <capability name="System colors in document resources" minToolsVersion="11.0"/>
         <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
     </dependencies>
     <scenes>
         <!--View Controller-->
         <scene sceneID="tne-QT-ifu">
             <objects>
-                <viewController id="BYZ-38-t0r" customClass="ViewController" customModule="RK_Setup_Git" customModuleProvider="target" sceneMemberID="viewController">
+                <viewController id="BYZ-38-t0r" customClass="ViewController" customModuleProvider="target" sceneMemberID="viewController">
                     <view key="view" contentMode="scaleToFill" id="8bC-Xf-vdC">
-                        <rect key="frame" x="0.0" y="0.0" width="393" height="852"/>
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
                         <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
-                        <subviews>
-                            <button opaque="NO" contentMode="scaleToFill" fixedFrame="YES" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="system" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="rr2-t4-Uvi">
-                                <rect key="frame" x="87" y="706" width="218" height="35"/>
-                                <autoresizingMask key="autoresizingMask" flexibleMaxX="YES" flexibleMaxY="YES"/>
-                                <state key="normal" title="Button"/>
-                                <buttonConfiguration key="configuration" style="plain" title="Button"/>
-                                <connections>
-                                    <action selector="startSurveyTapped:" destination="BYZ-38-t0r" eventType="touchUpInside" id="l4p-Pq-Qni"/>
-                                </connections>
-                            </button>
-                        </subviews>
+                        <color key="backgroundColor" xcode11CocoaTouchSystemColor="systemBackgroundColor" cocoaTouchSystemColor="whiteColor"/>
                         <viewLayoutGuide key="safeArea" id="6Tk-OE-BBY"/>
-                        <color key="backgroundColor" systemColor="systemBackgroundColor"/>
                     </view>
-                    <connections>
-                        <outlet property="startTapped" destination="rr2-t4-Uvi" id="LDX-yP-Jiu"/>
-                    </connections>
                 </viewController>
                 <placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
             </objects>
-            <point key="canvasLocation" x="93.89312977099236" y="3.5211267605633805"/>
         </scene>
     </scenes>
-    <resources>
-        <systemColor name="systemBackgroundColor">
-            <color white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
-        </systemColor>
-    </resources>
 </document>

RK-Setup-Git/SurveyTask.swift

@@ -1,27 +0,0 @@
-//
-//  SurveyTask.swift
-//  RK-Setup-Git
-//
-//  Created by Gerardo Marx Chávez Campos on 11/10/24.
-//
-
-import ResearchKit
-
-struct SurveyTaskProvider {
-    
-    static func createHeightFormTask() -> ORKOrderedTask {
-        
-        let sectionHeaderFormItem = ORKFormItem(sectionTitle: "What's your height?")
-        let heightQuestionFormItem = ORKFormItem(identifier: "heightQuestionFormItem1", text: nil, answerFormat: ORKAnswerFormat.heightAnswerFormat())
-        
-        heightQuestionFormItem.placeholder = "Tap here"
-        
-        let formStep = ORKFormStep(identifier: "HeighQuestionIdentifier", 
-                                   title: "Height info",
-                                   text: "Please answer the questions")
-        
-        formStep.formItems = [sectionHeaderFormItem, heightQuestionFormItem]
-        
-        return ORKOrderedTask(identifier: "Survey Task", steps: [formStep])
-    }
-}

RK-Setup-Git/ViewController.swift

@@ -6,72 +6,14 @@
 //
 
 import UIKit
-import ResearchKit
-import ResearchKitUI
-
 
 class ViewController: UIViewController {
-    
-    @IBOutlet weak var startTapped: UIButton!
-    
-    @IBAction func startSurveyTapped(_ sender: Any) {
-        presentHeightSurvey()
-    }
-    
+
     override func viewDidLoad() {
         super.viewDidLoad()
         // Do any additional setup after loading the view.
-        startTapped.setTitle("Start Survey", for: .normal)
     }
-    
-    func presentHeightSurvey() {
-        let taskViewController = ORKTaskViewController(task: SurveyTaskProvider.createHeightFormTask(), taskRun: nil)
-        taskViewController.delegate = self
-        present(taskViewController, animated: true, completion: nil)
-    }
-}
 
-// Extesions can be in other file:
 
-extension ViewController: ORKTaskViewControllerDelegate {
-    func taskViewController(_ taskViewController: ORKTaskViewController, didFinishWith reason: ORKTaskFinishReason, error: (any Error)?) {
-        
-        // Handle the completion of the task and dismiss the view controller
-        taskViewController.dismiss(animated: true, completion: nil)
-        
-        //handle error
-        guard reason == .completed else {
-            if let error = error {
-                print("The task was not completed: \(error.localizedDescription)")
-            }
-            return
-        }
-        
-        // processing results:
-        if let results = taskViewController.result.results as? [ORKStepResult] {
-            processSurveyResults(results)
-        }
-    }
-    
-    private func processSurveyResults(_ results: [ORKStepResult]) {
-        // here
-        for stepResults in results {
-            for result in stepResults.results! {
-                if let questionResult = result as? ORKQuestionResult {
-                    print("Question ID: \(questionResult.identifier)")
-                    processQuestionResult(questionResult)
-                }
-            }
-        }
-    }
-    
-    
-    private func processQuestionResult(_ result: ORKQuestionResult) {
-        if let heightResult = result as? ORKNumericQuestionResult, result.identifier == "heightQuestionFormItem1" {
-            if let heigth = heightResult.numericAnswer {
-                print("User's heigth is: \(heigth) cm")
-            }
-        }
-    }
-    
 }
+

Readme.md

@@ -0,0 +1,223 @@
+# RK-Setup-Git
+
+# Introduction 
+This repository explains how to setup ResearchKit V3 using Git Submodules. The repository has two branches: `example` and `main`. The `example` branch shows a basic sourvey task example using the added ResearchKit framework. Then, the `main` branch is a project reaady to start working with RK V3.
+
+
+## Example branch
+
+This section explains how to create a project to work with **ResearchKit v3** using Git submodules. The main idea is to use this repository as a starting point, however, if you want to create your own Xcode project from zero, follow the next guide
+
+### Step 1: Setting up the Xcode project
+
+To set up **ResearchKit v3** using **Git submodules**, you can include the ResearchKit repository as a submodule in your Xcode project instead of using CocoaPods. 
+
+1. Open Terminal and navigate to your Xcode project’s directory:
+
+```sh
+cd /path/to/your/project
+```
+
+2. Add the ResearchKit repository as a submodule:
+
+```sh
+git submodule add https\://github.com/ResearchKit/ResearchKit.git
+```
+
+3. Initialize and update the submodule:
+
+```sh
+git submodule update --init --recursive
+```
+
+This command will clone the ResearchKit repository into a ResearchKit folder inside your project directory.
+
+Thus, your project folder (in my case `RK-Setup-Git` should looks like the next image:
+
+![project](DA2y0wyAI-CleanShot_2024-10-11_at_16.55.13@2x.jpg)
+
+### Step 2: Add ResearchKit to Your Xcode Project
+
+1. Open your Xcode project or workspace.
+2. In the Xcode Project Navigator, right-click on the project’s root and select **Add Files to “YourProjectName”**.
+
+![adding RK](w3ujSOtx2-CleanShot_2024-10-11_at_17.00.34@2x.jpg)
+3. Browse to the ResearchKit folder you cloned as a submodule and select the ResearchKit.xcodeproj file.
+
+![adding the xcodeproj file](uLAeiu5Fl-CleanShot_2024-10-11_at_17.02.36@2x.jpg)
+
+4. Add ResearchKit as a dependency:
+  * Select your **Project** in the Project Navigator.
+  * Go to the **General** tab of your target.
+  * Under **Frameworks, Libraries, and Embedded Content**, click the **+** button.
+![CleanShot 2024-10-11 at 17.17.38@2x](w-4AupjJR-CleanShot_2024-10-11_at_17.17.38@2x.jpg)
+  * Select ResearchKit.framework (and other frameworks that you requiere) from the list (you should see it under “Workspace”).
+ ![CleanShot 2024-10-11 at 17.18.46@2x](9TyP3BaAn-CleanShot_2024-10-11_at_17.18.46@2x.jpg)
+5. **Set ResearchKit to Embed and Sign**:
+* Under **Frameworks, Libraries, and Embedded Content**, ensure that the ResearchKit.framework is set to **Embed & Sign**.
+![CleanShot 2024-10-11 at 17.24.12@2x](hGqSnwva6-CleanShot_2024-10-11_at_17.24.12@2x.jpg)
+### Step 3: Configure Build Settings**
+
+1. Go to the **Build Phases** tab for your app target.
+
+2. **Link ResearchKit**:
+
+* In the **Link Binary with Libraries** section, ensure that ResearchKit.framework is included.
+
+* If it is not listed, click the **+** button, and select ResearchKit.framework.
+
+![CleanShot 2024-10-11 at 17.28.09@2x](ICrsjPjwp-CleanShot_2024-10-11_at_17.28.09@2x.jpg)
+3. **Add ResearchKit as a Target Dependency**:
+
+* In the **Target Dependencies** section, click the **+** button and add ResearchKit.
+![CleanShot 2024-10-11 at 17.29.21@2x](E7AA2yFVA-CleanShot_2024-10-11_at_17.29.21@2x.jpg)
+
+**Step 4: Use ResearchKit in Your Project**
+
+Now that ResearchKit is properly set up as a submodule, you can start using it in your code:
+
+1. **Import ResearchKit** in the Swift files where you want to use it:
+
+```swift
+import ResearchKit
+```
+
+if you can write `import Resea` and Xcode shows the auto comple suggestion to include ResearchKit, your project is ready.
+
+![CleanShot 2024-10-11 at 17.33.22@2x](RFtEguouj-CleanShot_2024-10-11_at_17.33.22@2x.jpg)
+
+2. Create and present ResearchKit tasks as needed.
+
+**Summary**
+
+By using ResearchKit as a Git submodule, you gain more control over the version you’re using, and you keep dependencies managed directly through Git. This approach is especially useful when you want to track changes in ResearchKit or if you prefer not to use CocoaPods for dependency management.
+
+## Example of usage with a survey task
+
+For the implementation of this example we are going to add a new swift file, as shown in the following image and named it `SurveyTask`:
+
+![CleanShot 2024-10-11 at 17.38.33@2x](RZLt5GIeJ-CleanShot_2024-10-11_at_17.38.33@2x.jpg)
+
+The content of the `SurveyTask.swift` file[1^]:
+
+```swift
+import ResearchKit
+
+struct SurveyTaskProvider {
+    
+    static func createHeightFormTask() -> ORKOrderedTask {
+        
+        let sectionHeaderFormItem = ORKFormItem(sectionTitle: "What's your height?")
+        let heightQuestionFormItem = ORKFormItem(identifier: "heightQuestionFormItem1", text: nil, answerFormat: ORKAnswerFormat.heightAnswerFormat())
+        
+        heightQuestionFormItem.placeholder = "Tap here"
+        
+        let formStep = ORKFormStep(identifier: "HeighQuestionIdentifier", 
+                                   title: "Height info",
+                                   text: "Please answer the questions")
+        
+        formStep.formItems = [sectionHeaderFormItem, heightQuestionFormItem]
+        
+        return ORKOrderedTask(identifier: "Survey Task", steps: [formStep])
+    }
+}
+```
+
+
+The `ViewController` file should be modified to make and Outlet and Action for a button to deploy the Survey:
+
+```swift
+import UIKit
+import ResearchKit
+import ResearchKitUI
+
+
+class ViewController: UIViewController {
+    
+    @IBOutlet weak var startTapped: UIButton! // variable for the button
+    
+    @IBAction func startSurveyTapped(_ sender: Any) { // action for button
+        presentHeightSurvey()
+    }
+    
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        // Do any additional setup after loading the view.
+        startTapped.setTitle("Start Survey", for: .normal)
+    }
+    
+    func presentHeightSurvey() {
+        let taskViewController = ORKTaskViewController(task: SurveyTaskProvider.createHeightFormTask(), taskRun: nil)
+        taskViewController.delegate = self
+        present(taskViewController, animated: true, completion: nil)
+    }
+}
+
+// Extesions can be in other file:
+
+extension ViewController: ORKTaskViewControllerDelegate {
+    func taskViewController(_ taskViewController: ORKTaskViewController, didFinishWith reason: ORKTaskFinishReason, error: (any Error)?) {
+        
+        // Handle the completion of the task and dismiss the view controller
+        taskViewController.dismiss(animated: true, completion: nil)
+        
+        //handle error
+        guard reason == .completed else {
+            if let error = error {
+                print("The task was not completed: \(error.localizedDescription)")
+            }
+            return
+        }
+        
+        // processing results:
+        if let results = taskViewController.result.results as? [ORKStepResult] {
+            processSurveyResults(results)
+        }
+    }
+    
+    private func processSurveyResults(_ results: [ORKStepResult]) {
+        // here
+        for stepResults in results {
+            for result in stepResults.results! {
+                if let questionResult = result as? ORKQuestionResult {
+                    print("Question ID: \(questionResult.identifier)")
+                    processQuestionResult(questionResult)
+                }
+            }
+        }
+    }
+    
+    
+    private func processQuestionResult(_ result: ORKQuestionResult) {
+        if let heightResult = result as? ORKNumericQuestionResult, result.identifier == "heightQuestionFormItem1" {
+            if let heigth = heightResult.numericAnswer {
+                print("User's heigth is: \(heigth) cm")
+            }
+        }
+    }
+    
+}
+```
+
+* Finally add the button component:
+![CleanShot 2024-10-11 at 17.43.50@2x](0UFezqS5q-CleanShot_2024-10-11_at_17.43.50@2x.jpg)
+* drag and drop the button element:
+
+![CleanShot 2024-10-11 at 17.44.41@2x](BYbiPcQIc-CleanShot_2024-10-11_at_17.44.41@2x.jpg)
+* place the button in the area that you prefer:
+![CleanShot 2024-10-11 at 17.45.04@2x](-LVIKgGeZ-CleanShot_2024-10-11_at_17.45.04@2x.jpg)
+then, you must associate the already writted `@Outlet` and `@Action` by placing and extra editor at right pressing the **+** button as shown next:
+
+![CleanShot 2024-10-11 at 18.13.04@2x](GWe48wvO2-CleanShot_2024-10-11_at_18.13.04@2x.jpg)
+* Next, place at the left the `Main` story board (View controller scene) and at right the ViewCotroller code to associete the elements: 
+
+
+![CleanShot 2024-10-11 at 18.13.23@2x](5X1xHgjLf-CleanShot_2024-10-11_at_18.13.23@2x.jpg)
+Press `CTR` key and drag and drop the button element at the **@Outlet** and **@Action** code lines as shown next:
+
+![CleanShot 2024-10-11 at 17.52.58](cOVGAyV8--CleanShot_2024-10-11_at_17.52.58.gif)
+
+This means that the button component is now asociated with the `startTapped` var name and with the action when button is pressed. **Remember that you can create your own outlets and actions by dragging in any line at the viewcontroller file.**
+
+
+[1^]: [GitHub - ResearchKit/ResearchKit: ResearchKit is an open source software framework that makes it easy to create apps for medical research or for other research projects.](https://github.com/ResearchKit/ResearchKit)