Playground: Swift Playgrounds Author Template

Swift Playgrounds Author Template ile profesyonel Playground projeleri oluşturun!

Baran Önen
TurkishKit
4 min readMar 24, 2021

--

Merhaba sevgili TurkishKit okuyucuları! Bu yazımızda, Swift Student Challenge kazananı olma yolundaki ilk adımlardan biri olan Swift Playgrounds Author Template’in nasıl kullanılacağını anlatacağız. Öyleyse haydi başlayalım! 🚀

Swift Playgrounds Nedir?

Swift Playgrounds, Apple’ın genç yaştaki insanların interaktif ve eğlenceli bir şekilde Swift öğrenebilmesi için geliştirdiği bir uygulamadır.

Swift Playgrounds’un Mac App Store sayfası

Bu uygulamanın içerisinde Apple, Lego, Tello gibi organizasyonların hazırlamış olduğu Playground kitapçıklarını keşfedebilirsiniz. Tabii ki uygulama dışından edindiğiniz Playground kitapçıklarını da uygulama içerisinde deneyimleyebilirsiniz.

Geliştiriciler tarafından hazırlanmış olan Playground Book’larda genellikle Swift dilini kullanarak önceden hazırlanmış görevleri yerine getirmektedir.

Swift Playgrounds hakkında daha detaylı bilgi için bu konudaki makalemizi okuyabilirsiniz.

Playground Kitapçığı Nedir?

Playground kitapçığı (Playground Book), sol tarafta kodları ve geliştirici tarafından yazılan yönergeleri, sağ tarafta ise kodun çıktısını gösteren bir dosya formatıdır.

Bir kitap gibi sayfalar ve bölümlere sahip olan Playground Book’lar, Swift Playgrounds Author Template aracılığıyla geliştirilir.

macOS’te çalışan örnek bir Playground Book dosyası

Swift Playgrounds Author Template’i aşağıdaki link aracılığıyla Apple Developer sitesinden indirebilirsiniz.

Çıkan ekranda ücretli veya ücretsiz olması fark etmeksizin Developer hesabınızın şifresi istenecektir. Şifreyi girdikten sonra ise Author Template’in en son sürümünü indirdiğinize emin olun.

12.2 sürümü şu an Xcode’un son sürümü olan 12.4 ile uyumlu olsa da daha sonraki Xcode sürümleri için herhangi bir garanti verilemiyor. Eğer uyumluluk sorunları ile karşılaşırsanız, aynı sayfanın sol tarafındaki arama kutucuğunu kullanarak gerekli Xcode sürümünü indirebilirsiniz.

Apple Developer web sitesinin indirmeler sayfası

İndirme tamamlandıktan sonra “.dmg” türündeki dosyayı açarak “.xip” türündeki dosyaya ulaşın. Bu dosyayı da açtıktan sonra “PlaygroundBookTemplate” adındaki bir klasör, indirilenler klasörünüze eklenecek.

“PlaygroundBookTemplate” adındaki klasöre girin ve “PlaygroundBook.xcodeproj” adındaki Xcode projesini açın. Bu, Playground kitapçığını geliştirmek için kullanacağımız ana dosya olacak. (Şu ana kadar yaptığımız işlemi, bir iPhone uygulaması geliştirmek için yeni bir Xcode projesi oluşturmaya benzetebilirsiniz.)

PlaygroundBook dosyasının Xcode ile açılmış hali

Şimdi biraz da olsa kod yazma zamanı! Ekranın sol tarafında bulunan sidebar aracılığıyla Chapters > Chapter1.playgroundchapter > Pages > PlaygroundPage.playgroundpage > LiveView.swift dosyasını açın. Eğer sidebar gözükmüyorsa pencere kontrollerinin hemen sağında bulunan tuşa basın.

Açılan dosyaya yukarıdaki kodu ekleyerek “PlaygroundBook”un ilk sayfasına “Merhaba sevgili TurkishKit okuyucuları!” yazısını ekleyin. (Yukarıdaki kod ile basit bir arayüz tasarladık.)

Daha sonra “Target” olarak “LiveViewTestApp” ve Mac’inizi seçin. (Seçenekler, bilgisayarınızın bir Apple Silicon çip veya Intel işlemciye sahip olmasına göre değişkenlik gösterebilir.)

“Target” seçimini yaptıktan sonra sidebar aracılığıyla “PlaygroundBook” adındaki en üstteki dosyaya tıklayın. Ardından sol taraftan “LiveViewTestApp”i seçin. Burada “Team” kısmına gelin ve geliştirici hesabınızı seçin. Eğer hiç bir seçenek gözükmüyorsa “Add an Account…” seçeneğini kullanın.

Şimdi cmd+B tuşlarını kullanarak projeyi “build” edin.

“Build” işleminden kısa bir süre sonra “LiveViewTestApp” adında bir uygulamanın açılması gerekiyor. Uygulamanın Dock’taki ikonuna sağ tıklayarak Seçenekler > Finder’da Göster yolunu izleyin.

Tebrikler! Playground Book’unuzun “build” edileceği klasörü buldunuz. Geliştirmenin bundan sonraki aşamalarında projenizi Swift Playgrounds’da test edeceğiniz zaman “Build Target” olarak Mac’inizi seçip bu yolu izlemeniz gerekiyor.

Şimdi tekrardan PlaygroundBook > iPad (istediğiniz bir model olabilir) seçeneğini “Target” olarak işaretleyin. cmd+shift+K kısayolunu kullanarak “build” klasörünü temizleyin ve cmd+B ile tekrardan projenizi “build” edin.

Xcode’daki bir hata yüzünden her build işleminde öncelikle klasörü bu şekilde temizlemeniz gerekiyor.

“LiveViewTestApp” uygulamasının konumunu açmak istediğinizde açılan pencereye tekrardan gelerek Products > Debug-iphonesimulator yolunu izleyin. Ardından “PlaygroundBook.playgroundbook” dosyasını açın. Eğer Playground kitapçığınızı iPad’inizde test etmek istiyorsanız dosyayı AirDrop aracılığıyla iPad’inize yollayabilirsiniz.

Tebrikler, Swift Student Challenge yolunda ilk adımlardan birini attınız! 🎉

Umarım ki bu yazı sizlere yardımcı olabilmiştir. Bir sonraki yazımızda görüşmek üzere! 👋

Bizi daha yakından takip etmek istiyorsanız, sosyal medya hesaplarımıza aşağıdan ulaşabilirsiniz!

Twitter | Instagram | Facebook

--

--