OGS-Main
/
ogs-site

<!DOCTYPE html>
<head>
    <meta charset="utf-8" />
    <!-- Set the viewport width to device width for mobile -->
    <meta name="viewport" content="width=device-width" />

    <title>Самоучитель iOS</title>

    <link rel="stylesheet" href="https://kaisd.github.io/ogs-site/theme/css/normalize.css" />
    <link rel="stylesheet" href="https://kaisd.github.io/ogs-site/theme/css/foundation.min.css" />
    <link rel="stylesheet" href="https://kaisd.github.io/ogs-site/theme/css/style.css" />
    <link rel="stylesheet" href="https://kaisd.github.io/ogs-site/theme/css/pygments.css" />	
    <script src="https://kaisd.github.io/ogs-site/theme/js/custom.modernizr.js"></script>

    <!-- So Firefox can bookmark->"abo this site" -->
        <link href="feeds/all.atom.xml" rel="alternate" title="Opensource Game Studio" type="application/atom+xml">

</head>

<body>

<!-- Nav Bar -->
<nav>

<!-- Show menu items and pages -->
<div class="row">
    <div class="large-12 columns top-bar">
	    <h1><a href="https://kaisd.github.io/ogs-site">Opensource Game Studio</a></h1>
    </div>
</div>
<div class="row top-menu">
<div class="large-12 columns">
        <a href="pages/projects.html" class="menu-button secondary">Projects</a>
        <a href="pages/about.html" class="menu-button secondary">About</a>

</div>
</div>
</nav>
<!-- End Nav -->


<!-- Main Page Content and Sidebar -->
<div class="row">

    <!-- Main Blog Content -->
    <div class="large-9 columns">
<article>
    <header>
        <h3 class="article-title"><a href="https://kaisd.github.io/ogs-site/ios-tutorial-ru.html" rel="bookmark"
        title="Permalink to Самоучитель iOS">Самоучитель iOS</a></h3>
    </header>

<h6 class="subheader" title="2017-06-08T10:00:00+03:00">Thu 08 June 2017
            <a class="button secondary small translation-button" href="https://kaisd.github.io/ogs-site/ios-tutorial.html">en</a>

</h6>    <p><img alt="Самоучитель iOS" src="https://kaisd.github.io/ogs-site/2017-06-08-ios-refactoring.png"></p>
<p>Эта статья описывает проблемы, с которыми мы столкнулись во время создания самоучителя для iOS в мае 2017.</p>
<p><a href="https://twitter.com/OpenGameStudio/status/826816343433498627">В феврале</a> мы сумели отобразить простую модель под iOS за считанные дни. Это дало нам уверенность, что самоучитель для iOS мы сделаем столь же быстро. Тем не менее, реальность напомнила нам о простой вещи: быстро сделать можно лишь поделку на коленке, работающую только у самого разработчика; над логически связанным примером, работающим у всех, придётся попотеть.</p>
<h3>Нативная библиотека</h3>
<p>Прежде всего нам необходимо было ответить на следующий вопрос: "должен ли пример приложения быть частью проекта Xcode или отдельной библиотекой?"</p>
<p>Для принятия решения мы использовали следующие факты:</p>
<ol>
<li>Проект Xcode может напрямую использовать C++ (благодаря Objective-C++) без прослоек вроде JNI<ul>
<li>Отдельная библиотека не нужна (+ приложение)</li>
<li>Создание отдельной библиотеки - это дополнительная работа (- библиотека)</li>
</ul>
</li>
<li>OpenSceneGraph собирается в библиотеки<ul>
<li>Легче использовать стандартный процесс сборки (+ библиотека)</li>
<li>Создавать свой процесс сборки лишь для одной платформы сложно (- приложение)</li>
</ul>
</li>
<li>OpenSceneGraph использует систему сборки CMake, которая не поддерживается Xcode<ul>
<li>Проект Xcode не может включать файлы CMake (- приложение)</li>
<li>Свой файл CMake может с лёгкостью включить файл OpenSceneGraph CMake для сборки единой библиотеки (+ библиотека)</li>
</ul>
</li>
<li>CMake может генерировать проект Xcode<ul>
<li>Можно создать файл CMake, который будет собирать как OpenSceneGraph, так и пример приложения (+ приложение)</li>
<li>Xcode - это де-факто инструмент для создания проектов Xcode; легче использовать стандартный процесс сборки (+ библиотека)</li>
</ul>
</li>
</ol>
<p>Оценив плюсы и минусы обоих подходов, мы решили сделать библиотеку, которую можно включать в проект Xcode. Минусом данного подхода является то, что сборки приложения для симулятора и реального устройства используют разные сборки библиотеки.</p>
<h3>Рефакторинг</h3>
<p>Также нам пришлось ответить на ещё один вопрос: "использовать ли единую кодовую базу для всех платформ или несколько под каждую платформу?"</p>
<p>При создании самоучителя для Android мы использовали единую кодовую базу, т.к. она отлично работала для десктопа и Android. Когда мы начали работу над самоучителем iOS, стало ясно, что часть функционала либо работает, либо не работает на некоторых платформах. Например, один функционал может работать на десктопе и iOS, но не работать на Android. Другой функционал может работать на iOS и Android, но не работать на десктопе. Т.к. мы не хотели загрязнять код кучей #ifdef, мы решили помещать функционал, специфичный для конкретной платформы или нескольких платформ, в разные файлы. Это привело к резкому увеличению количества файлов. Такой подход хорошо подходил для повторного использования, но совершенно не годился для понимания общей картины.</p>
<p>В этот момент мы осознали необходимость ответа на второй вопрос. Мы напомнили себе, что главная цель примера приложения состоит в том, чтобы обучить базовым вещам OpenSceneGraph, а не создать повторно используемую библиотеку с API, который будет жить без изменений десятилетиями.</p>
<p>Для ответа на этот вопрос нам помог наш внутренний инструмент feature tool. С его помощью мы разделили код на несколько частей, который в итоге собирается ровно в два файла для каждой платформы:</p>
<ol>
<li>functions.h - содержит повторно используемые бесклассовые функции</li>
<li>main.h - содержит остальной код приложения</li>
</ol>
<p>Их содержимое несколько отличается для каждой из платформ, но наличие всего двух файлов позволяет увидеть общую картину.</p>
<p>На этом мы заканчиваем описание проблем, с которыми мы столкнулись во время создания самоучителя для iOS в мае 2017.</p>
<p class="subheader">Category: <a href="https://kaisd.github.io/ogs-site/category/news.html">News</a>

</p>


</article>
    </div>
    <!-- End Main Content -->

    <!-- Sidebar -->
    <aside class="large-3 columns">
        <!--k
        <h5 class="sidebar-title">Site</h5>
        <ul class="side-nav">
            <li><a href="https://kaisd.github.io/ogs-site/archives.html">Archives</a>
            <li><a href="https://kaisd.github.io/ogs-site/tags.html">Tags</a>


                <li><a href="https://kaisd.github.io/ogs-site/feeds/all.atom.xml" rel="alternate">Atom feed</a></li>
        </ul>

		
        <h5 class="sidebar-title">Categories</h5>
        <ul class="side-nav">
            <li><a href="https://kaisd.github.io/ogs-site/category/news.html">News</a></li>
            <li><a href="https://kaisd.github.io/ogs-site/category/stub.html">Stub</a></li>
   
        </ul>
        -->


        <h5 class="sidebar-title">Projects</h5>
        <ul class="side-nav">
            <li><a href="pages/ogs-mahjong.html">OGS Mahjong</a></li>
            <li><a href="pages/ogs-editor.html">OGS Editor</a></li>
            <li><a href="pages/openscenegraph-guide.html">OpenSceneGraph guide</a></li>
        </ul>
		

    </aside> <!-- End Sidebar -->

</div> <!-- End Main Content and Sidebar -->


<!-- Footer -->
<footer class="row">
    <div class="large-12 columns">
        <hr />
        <div class="row">
            <div class="large-7 columns">
                <p>Proudly powered by <a href="http://getpelican.com">Pelican</a>, which takes great advantage of <a href="http://python.org">Python</a>.</p>
            </div>
            </div>
    </div>
</footer>