{"id":29190628,"url":"https://github.com/owncloud/ios-library","last_synced_at":"2025-07-02T00:10:38.817Z","repository":{"id":54959470,"uuid":"14743553","full_name":"owncloud/ios-library","owner":"owncloud","description":null,"archived":false,"fork":false,"pushed_at":"2018-08-28T15:47:52.000Z","size":7330,"stargazers_count":75,"open_issues_count":15,"forks_count":85,"subscribers_count":55,"default_branch":"master","last_synced_at":"2025-06-28T18:13:13.706Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/owncloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-11-27T10:08:04.000Z","updated_at":"2025-02-16T10:56:47.000Z","dependencies_parsed_at":"2022-08-14T07:30:23.852Z","dependency_job_id":null,"html_url":"https://github.com/owncloud/ios-library","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/owncloud/ios-library","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owncloud%2Fios-library","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owncloud%2Fios-library/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owncloud%2Fios-library/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owncloud%2Fios-library/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/owncloud","download_url":"https://codeload.github.com/owncloud/ios-library/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/owncloud%2Fios-library/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263052430,"owners_count":23406106,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-02T00:10:38.184Z","updated_at":"2025-07-02T00:10:38.786Z","avatar_url":"https://github.com/owncloud.png","language":"Objective-C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ownCloud iOS Library v 2.2.1\n\n### Introduction\nUsing ownCloud iOS library it will be the easiest way to communicate with ownCloud servers.\nAdd this library in your project and integrate your application with ownCloud seamlessly.\n\n### Install Library\n#### 2.1. Information how to get the library\nGet this code and compile with Xcode 8. In the repository it is not only the library project “ownCloud iOS library” but also the example project “OCLibraryExample”. Thanks to the “OCLibraryExample” you will learn how to use the library.\n#### 2.2. Add library to your project\nThere are two ways of adding this library to your code:\n\nMethod 1. Reference the headers and the library binary file (.a) directly.\n\nMethod 2. Include the library project as a Subproject.\n\nChoosing one method or the other one just depends on your own preferences as well as whether you have the source code and the project file of the static library at your disposal.\n\n##### Method 1: Header and library binary files\n__Step 1__.  Compile the \"ownCloud iOS library\" and run the project, the libownCloudiOS.a will be generated. \n\nYou need these files: \n\n__Library File__\n\n* libownCloudiOS.a (Library) \n\n__Library Classes__\n\n* OCComunication.h (Accesors) Import in the communication classes\n* OCErrorMsg.h (Error messages) Import in the communication classes\n* OCFileDto.h (File/Folder object) Import when you use readFolder and readFile methods\n* OCFileDto.m\n* OCFrameworkConstants.h (Customize constants)\n* OCSharedDto.h \n* OCSharedDto.m\n* OCShareUser.h\n* OCShareUser.m\n\n__Step 2.__  Add the library file in your project.  Link the library file in your project target. \"build phases\" -\u003e \"Link binary with libraries\" and tap in \"+\" and select the library file.\n\n  \n__Step 3.__  Add the path of the library headers. In your project target \"build settings\" in the option \"Header Search Paths\" add the path.\n\n__Step 4.__  In your project target \"build settings\" add the flag \"-Obj-C\" to the \"Other Linker Flag\" option\n\n\n##### Method 2: Subprojects\n\n__Step 1.__ Add the file \"ownCloud iOS library.xcodeproj\" to your project using drag and drop.\n\n\n__Step 2.__ In your project target go to \"build phases\" -\u003e \"Target Dependencies\" and tap in \"+\" and select the library target.\n\n__Step 3.__ Now link the library file in your project target. \"build phases\" -\u003e \"Link binary with libraries\" and tap in \"+\" and select the library file.\n\n__Step 4.__ In your project target \"build settings\" add the flag \"-Obj-C\" to the \"Other Linker Flag\" option\n\n__Step 5.__ And finally, add the path of the library headers. In your project target \"build settings\" in the option \"Header Search Paths\" add the path.\n\n__Source:__\n\nRayWenderlich.com \u003chttp://www.raywenderlich.com/41377/creating-a-static-library-in-ios-tutorial\u003e\n \nApple.com \u003chttps://developer.apple.com/library/ios/technotes/iOSStaticLibraries/Articles/configuration.html#/apple_ref/doc/uid/TP40012554-CH3-SW2\u003e\n\n### Branching strategy\n\nThe repository holds two main branches with an infinite lifetime:\n\n- stable\n- master\n\nBranch __origin/stable__ is considered the main branch where the source code of HEAD always reflects a production-ready state.\n\nBranch __origin/master__ is considered the main branch where the source code of HEAD always reflects a state with the latest delivered development changes for the next release.\n\nWhen the source code in the master branch reaches a stable point and is ready to be released, all of the changes should be merged back into stable somehow and then tagged with a release number. \n\nOther branches, some supporting branches are used to aid parallel development between team members, ease tracking of features, prepare for production releases and to assist in quickly fixing live production problems. Unlike the main branches, these branches always have a limited life time, since they will be removed eventually.\n\nThe different types of branches we may use are:\n\n- Branch __perNewFeature__    \n- Branch  __releaseBranches__\n\nBoth of them branch off from master and must merge back into stable branch through a Pull Request in Github. Once the PR is approved and merged, the US branch may be deleted\n\nSource: http://nvie.com/posts/a-successful-git-branching-model  \n\n### License\n\nownCloud iOS library is available under the MIT License. \n \nCopyright (c) 2017 ownCloud (http://www.owncloud.org/)\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n#### Third party libraries\n\nownCloud iOS library uses AFNetworking version 3.1.0 AFNetworking is available under the MIT license. \n\nownCloud iOS library uses some classes based in  https://github.com/zwaldowski/DZWebDAVClient. Copyright (c) 2012 Zachary Waldowski, Troy Brant, Marcus Rohrmoser, and Sam Soffes under the MIT license.\n\n\n### Compatibility\n\nownCloud iOS library supports iOS 9, iOS10, iOS11 and works in Xcode 8 and Xcode 9.\n\nownCloud iOS library supports ownCloud server from version 4.5.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowncloud%2Fios-library","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fowncloud%2Fios-library","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fowncloud%2Fios-library/lists"}