Cocoa, the Swift standard library,

Cocoa, the Swift standard library, maybe even your own types and methods—it’s all about to change, and you can help determine how.

Ever since before Swift was released, there’s been a style gap between Cocoa interfaces and APIs in the Swift standard library; lots of things just look different, often needlessly so. This is no mere aesthetic concern; non-uniformity and lack of predictability make everything harder, from coding to debugging to maintenance. Fortunately Swift developers created tons of great code in spite of that gap, and along the way, there evolved a sense of what “Swifty” code looks and feels like.

Informed by that experience, when looking at our APIs, it’s easy to see there’s room for improvement, both in the way the compiler imports Objective-C APIs—where the results just don’t seem quite comfortable in Swift—and in the Swift standard library, which lacks a level of regularity and coherence that Cocoa users have come to expect. So we at Apple decided to do something about it.

In order to converge Cocoa and the standard library, we needed a target to shoot for: a unified, written approach to API design that everyone could follow. We started by going back and questioning all our old assumptions. Existing guidelines were fantastic, but much of the material was geared to Objective-C, didn’t cover Swift-specific features such as default arguments, and more importantly, were not informed by the emergent sense of “Swiftiness” that we felt was so important to capture.

As we developed these guidelines we applied them to the standard library, all of Cocoa, and a couple of sample projects. We evaluated the results, refined, and repeated. Before Swift went open source, we’d have done this all behind closed doors, and presented you with the results in the next release, but a new era has dawned on Swift: it’s time to show the world what we’ve been up to. Here’s a tiny example of how code looks before transformation:

ผลลัพธ์ (ไทย) 1:

โกโก้ ห้องสมุดมาตรฐาน Swift แม้ชนิดและวิธีการของคุณเอง — มันเป็นทั้งหมดเกี่ยวกับการเปลี่ยนแปลง และคุณสามารถช่วยกำหนดวิธีการตั้งแต่ก่อนวางจำหน่าย Swift มีช่องว่างแบบอินเทอร์เฟซของโกโก้และ APIs ในไลบรารีมาตรฐานทางรวดเร็ว สิ่งของมากมายเพียงแค่มองแตกต่างกัน จึงมักจะ needlessly เหล่านั้น นี้เป็นเรื่องความสวยงามไม่เพียง ไม่สม่ำเสมอและขาดการคาดการณ์ทำให้ทุกอย่างยาก จากรหัสการตรวจแก้จุดบกพร่องการบำรุงรักษา โชคดีนักพัฒนาอย่างรวดเร็วสร้างตันของรหัสดี ทั้ง ๆ ที่ช่องว่าง และวิธีการ พัฒนาของรหัส "Swifty" และรู้สึกเหมือนมีทั้งในแบบคอมไพเลอร์ทราบ โดยประสบการณ์ที่ เมื่อเรา APIs ง่ายต่อการดูมีการปรับปรุง นำเข้าวัตถุประสงค์-C APIs — ที่ผลลัพธ์เพียงดูเหมือนค่อนข้างสบายใน Swift — และในไลบรารีมาตรฐานทางรวดเร็ว ซึ่งขาดสม่ำเสมอและโปรเจคที่ผู้ใช้โกโก้มาคาดหวัง ดังนั้น เราที่ Apple ตัดสินใจทำอะไรมันเพื่อบรรจบโกโก้และไลบรารีมาตรฐาน ที่เราต้องการให้เป้าหมายในการถ่ายภาพ: วิธีการออกแบบ API ที่ทุกคนสามารถทำตามแบบประกอบการ เขียน เราเริ่มกลับไป และตั้งคำถามสมมติฐานเก่าทั้งหมด แนวทางที่มีอยู่ได้ยอดเยี่ยม แต่มากของวัสดุถูกมุ่งเพื่อวัตถุประสงค์ ไม่ได้ครอบคลุมคุณลักษณะเฉพาะของ Swift เช่นเริ่มต้นอาร์กิวเมนต์ และสำคัญ ได้ทราบที่โผล่ออกมาของความรู้สึกของ "Swiftiness" ที่เราให้ความสำคัญในการจับภาพเราพัฒนาแนวทางเหล่านี้เราประยุกต์ใช้ไลบรารีมาตรฐาน โกโก้ทั้งหมด และคู่ของตัวอย่างโครงการ เราประเมินผล กลั่น และซ้ำ ก่อน Swift ไปเปิด แหล่งที่มา เราจะทำทั้งหมดนี้หลังปิดประตู และแสดงผลลัพธ์ในรุ่นถัดไป แต่ยุคใหม่มี dawned กับ Swift: เวลาที่จะแสดงให้โลกอะไรได้ถึง นี่คือตัวอย่างเล็ก ๆ ของลักษณะที่ปรากฏของรหัสก่อนที่จะแปลง:

ผลลัพธ์ (ไทย) 2:

โกโก้ห้องสมุดสวิฟท์มาตรฐานบางทีแม้แต่ชนิดของคุณเองและวิธีการมันคือทั้งหมดที่เกี่ยวกับการเปลี่ยนแปลงและคุณสามารถช่วยกำหนดวิธี. นับตั้งแต่ก่อนที่สวิฟท์ได้รับการปล่อยตัวมีการช่องว่างสไตล์ระหว่างการเชื่อมต่อโกโก้และ API ในสวิฟท์ห้องสมุดมาตรฐาน ; จำนวนมากสิ่งที่เพียงแค่มองที่แตกต่างกันมักจะไม่มีความจำเป็นเพื่อให้ นี้ไม่เพียงความกังวลความงาม; ไม่ใช่ความสม่ำเสมอและการขาดการคาดการณ์ทำให้ทุกอย่างยากขึ้นจากการเขียนโปรแกรมเพื่อแก้จุดบกพร่องในการบำรุงรักษา โชคดีที่นักพัฒนาสวิฟท์ที่สร้างขึ้นตันของรหัสที่ดีทั้งๆที่มีช่องว่างและพร้อมกันนี้ยังมีการพัฒนาความรู้สึกของสิ่ง "Swifty" รหัสดูและรู้สึกเหมือนก. แจ้งจากประสบการณ์ที่เมื่อมองไปที่ API สำหรับเรามันเป็นเรื่องง่ายที่จะเห็นมี ห้องสำหรับการปรับปรุงทั้งในวิธีการที่นำเข้าคอมไพเลอร์ Objective-C-APIs ที่ผลก็ไม่ได้ดูเหมือนค่อนข้างสะดวกสบายในสวิฟท์และสวิฟท์ในห้องสมุดมาตรฐานซึ่งขาดระดับของความสม่ำเสมอและการเชื่อมโยงกันว่าผู้ใช้โกโก้ได้มาถึง คาดหวัง ดังนั้นเราที่แอปเปิ้ลตัดสินใจที่จะทำบางสิ่งบางอย่างเกี่ยวกับมัน. เพื่อที่จะมาบรรจบกันโกโก้และห้องสมุดมาตรฐานเราจำเป็นต้องมีเป้าหมายในการถ่ายภาพสำหรับ: แบบครบวงจร, วิธีการเขียนในการออกแบบ API ที่ทุกคนสามารถปฏิบัติตาม เราเริ่มต้นด้วยการไปกลับมาและตั้งคำถามทุกข้อสมมติฐานเดิมของเรา แนวทางที่มีอยู่เป็นที่ยอดเยี่ยม แต่มากของวัสดุที่ถูกมุ่งไปที่วัตถุประสงค์ -C ไม่ครอบคลุมคุณสมบัติสวิฟท์ที่เฉพาะเจาะจงเช่นการขัดแย้งเริ่มต้นและที่สำคัญยังไม่ได้รับแจ้งจากความรู้สึกที่โผล่ออกมาของ "Swiftiness" ที่เรารู้สึกว่าเป็นเช่นนั้น สิ่งสำคัญที่จะจับ. ในฐานะที่เราพัฒนาแนวทางเหล่านี้เรานำพวกเขาไปห้องสมุดมาตรฐานทั้งหมดของโกโก้และคู่ของโครงการตัวอย่าง เราประเมินผลการกลั่นและทำซ้ำ ก่อนที่จะไปสวิฟท์เปิดแหล่งที่มาเราจะได้ทำทั้งหมดนี้ปิดประตูและนำเสนอคุณกับผลลัพธ์ที่ได้ในรุ่นถัดไป แต่ยุคใหม่ได้ dawned กับสวิฟท์: ถึงเวลาที่จะแสดงให้โลกเห็นสิ่งที่เราได้รับการขึ้นไป . นี่เป็นตัวอย่างเล็ก ๆ ของวิธีดูรหัสก่อนการเปลี่ยนแปลง: