0:00
[MUSIC]
So now let's write that whole application from scratch.
The first thing which we do is we open Xcode.
In Xcode we say we want to create a new Xcode project.
You create a new Xcode project.
Then you can see here all the different capabilities, right?
So we can write an Xcode application for iOS, right?
So this is an area where we'd select an iOS application.
We can write applications for the watch OS, we can write applications for the TV.
We can write applications for OS X, which is the desktop, right.
And what I want to do is here I want to write an application for
the desktop from this sample here.
So then I select I want to write a Cuckoo operation.
Remember, Cuckoo is the framework which allows us
to handle all the user interaction and
that framework is written in Objective-C and we are bridging into it.
So I say next, and I need to give it a name.
So I call that Speaking Text Editor,
let's give it a number, three.
So Ralf Brockhaus, come Smilefish, Swift.
So in programming language you can select here.
I select Swift.
I want to use storyboards, which I will explain in a minute.
And I want to create a document-based application.
By selecting that I want to create a document-based application,
I get a lot of this functionality out of the box, right?
So my sample,
or my initial template application will already have a lot of the plumbing,
a lot of the capabilities to actually read and write to the file system.
To handle multiple views from multiple documents, all that is built
already in that template, all right, so that's a great place to start.
So by sending next, it wants me to store that, I create this application,
1:58
and I bring Xcode here in to full-screen mode, right.
So next thing which we see here,
inside the application we have a few things actually out of the box, right?
So every application has an application delegate.
What happens with the application delegate is
when you select an icon of an application, whatever form,
tell the operating system to launch a certain application.
Then the operating system will launch the application, and then afterwards it will
handle all the events coming from the application, from the operating system,
going to the application, will be handled in the AppDelegate.
So it's an NSApplicationDelegate as a base class,
with a protocol which implement here and vice versa.
And then we have two functions here, application has finished launching.
So if we wanted to do something specific in that moment we could insert that
code here, or before the application terminates,
we could enter some code here which would actually then store information, right?
So that's the application delegate.
If we wanted to handle geopositioning or
anything then we would add that here to this code.
The next thing we want to look at here is the document Swift.
So because I selected that I wanted to have a document based application
3:20
the Xcode environment already created a document class here for me.
Document class inherits form NS document.
And it has a couple of functions actually already built in.
There's an initializer here, there's a function to make the window controllers,
like this function here will actually be called in the moment when I say okay,
I want to add another window, I want to open a window.
And then it will want to make a window controller for me, and
add that to our application, right, so our running application.
So this code would be executed in that moment.
Also later when I write here the code to load the data from a file or
to write the data out, then these two functions will become essential.
But we don't need to start there.
So the next thing what you want to look at is actually our view controller.
And so in our view controller, we have a function viewDidLoad,
and we have a function represented object.
I leave those functions in place for the moment.
What I want to add here is a few things.
So the first thing which I want is in our application,
we need a field where we can enter the text, right?
So somebody can either enter the text or display the text, right.
Remember we're talking about the view, we need a view component, right?
So the view component we used here,
IBOutlet, that's another thing I need to explain in a second.
So we have a variable and call this TextView and
our text views of type NSTextView.
So is that in the introduction, the beginning.
That's one more thing, and return.
5:09
So when we write the user interface, then we use actually the Interface Builder.
A tool called Interface Builder originally,
meanwhile that tool is built into Xcode, but the pre-compiler directives IBOutlet,
the IB stands for Interface Builder, they still exist, right?
And I have a variable here, and my textView is of NSTextView type, right?
And when I later write the user interface in the Interface Builder,
then I need to link up the user interface component in the view
with the user interface component in my controller.
And that's what this little dot means here.
So we have an IBOutlet to connect the interface with the controller.
And we have, this is not filled, this cycle.
Which means it has not connected at this moment, which is fine.
The next thing which I want to write is two little functions.
6:07
And those functions are functions which I want to trigger when I hit the speak
button or the stop button, right?
And so the way how I do that is,
I create an IB action, a function in this case.
6:37
So this is my function which is being called when somebody speaks,
when somebody wants to press the speak button.
Now, what I can do here is very quick is I can say a print, and
in this case it's like kind of something like Speak button,
7:01
Click to say something like
testView.textstring.
That's kind of tricky.
Sometimes you need to know the name of the variables, right, so in this case, and
then we need to close this and close that, and then there should be no errors.
7:22
Right, so what happens here, if somebody presses the Speak button,
then we will actually print a string.
And what we will do is we will ask our text view to give us
the string which is currently in the text view.
So the class we are working, writing is the viewController.
Right, it's that the model, the view, and the controller.
So in the view we will have the text box, and
we will have the button Speak and the button Stop.
In the controller we will have all the business logic, right.
And so if you press a button in the view, the view handles the press itself, but
then the call is being sent to the controller, and
the controller does everything that needs to be done then.
Controller does the action.
In this case the controller will ask the view, give me the text view, and
from the text view give me the string which is currently displayed, and
then I will just print it here to the console.
8:17
Now the other function which I need is
an IBAction function.
Something like StopButtonClicked,
and the sender Is also an NSButton.
and what I want to do here is
I just print stop button clicked, right?
So this is now the very initial code, right?
So find was our very initial code.
We cannot do very much, right, so we need to write our user interface.
So if I go here into our main storyboard,
9:11
there's a couple of things which happen here in our application, right.
The first thing is if I look here at how our project is set up.
Then inside our project properties, so I can do that by selecting here,
our project file itself.
Then I can see here that the menu's interface is in the file main, and so
that's the main storyboard.
In the initial scene for
the storyboard here, I have on the very top, the main menu.
So, when I created this project as a document-based project,
then it already provided me here with quite a few things.
So, given the name of the application, sub menu, the file sub menu, the edit,
the format, so this is the main menu inside my application,
I can expand that, but that's beyond this class.
I have a window controller and
the window controller controls basically all the different windows for this file.
And so each time when I open a new file, I basically call the window controller from
the storyboard and the window controller then brings up my view controller.
Justin-Nicholas ToyamaUCI Extension Instructor
Frank AyarsUCI Extension Instructor
Ralf BrockhausUCI Extension Instructor
