执行上下文


在本单元中，我们将逐步介绍设置新的Flutter项目、理解项目结构、在不同平台上运行应用程序以及向应用程序添加基本功能和样式的过程。

## 设置项目并运行Flutter应用程序

### 创建一个新的Flutter项目

要创建一个新的Flutter项目，请打开终端或命令提示符，并导航到您想要创建项目的目录。然后运行以下命令：

```bash
flutter create my_app
```

将"my_app"替换为您的项目名称。此命令将创建一个名为"my_app"的新目录，并包含Flutter项目所需的所有文件和目录。

### 理解项目结构

Flutter项目具有特定的结构。以下是您应该了解的最重要的目录和文件：

- lib/：这是您编写Dart代码的位置。应用程序的主入口点（main.dart）位于此目录中。
- test/：此目录用于测试应用程序。
- android/和ios/：这些目录分别包含Android和iOS的文件。通常情况下，您不需要修改这些文件。
- pubspec.yaml：此文件用于管理应用程序的软件包和资源。

### 运行Flutter应用程序

要运行Flutter应用程序，请在终端中导航到项目目录，并运行以下命令：

```bash
flutter run
```

此命令会构建并将Flutter应用程序安装到连接的设备或模拟器中。

## 添加功能和优化

### 为应用程序添加交互性

在Flutter中，一切都是小部件。要为应用程序添加交互性，可以使用有状态的小部件。有状态的小部件可以随时间改变（例如，根据用户交互更改外观的小部件）。

### 实现基本UI元素

Flutter提供了丰富的小部件集合，用于创建复杂的用户界面。例如，您可以使用Container小部件进行填充，使用Row和Column小部件进行布局，使用Text小部件显示文本。

### 为应用程序添加样式

Flutter提供了强大的样式系统。您可以通过向MaterialApp小部件提供ThemeData来为应用程序设置样式。ThemeData可以指定应用程序的颜色、排版和形状。您还可以使用特定的样式属性来为单个小部件设置样式。

在下一个单元中，我们将学习如何为我们的Flutter应用程序添加高级功能。敬请关注！


Building a Basic Application with Flutter


Go 是一种编程语言，它提供了一种简单而有效的错误处理机制。 Go 的错误处理主要基于两个概念：错误类型和错误值。

在 Go 中，错误类型是一个接口类型，定义了一个名为 `error` 的预定义接口。该接口只有一个方法 `Error()`，它返回一个字符串，表示错误的描述信息。任何实现了 `error` 接口的类型都可以被视为一个错误类型。

错误值则是实现了 `error` 接口的具体实例。当出现错误时，通常会返回一个错误值来表示错误的发生。在函数调用中，通常会将错误作为函数的最后一个返回值返回。如果没有错误发生，错误值为 `nil`。

下面是一个简单的示例，展示了如何在 Go 中处理错误：

```go
package main

import (
	"errors"
	"fmt"
)

func divide(x, y int) (int, error) {
	if y == 0 {
		return 0, errors.New("division by zero")
	}
	return x / y, nil
}

func main() {
	result, err := divide(10, 2)
	if err != nil {
		fmt.Println("Error:", err)
	} else {
		fmt.Println("Result:", result)
	}
}
```

在上面的示例中，`divide` 函数用于执行整数除法运算。如果除数为零，则返回一个错误值，表示发生了除以零的错误。在 `main` 函数中，我们调用 `divide` 函数，并使用错误值进行错误检查。如果错误值不为 `nil`，则打印错误信息；否则，打印计算结果。

Go 还提供了一种更简便的错误处理方式，即使用 `errors` 包中的 `Errorf` 函数。该函数类似于 `fmt.Printf`，可以通过格式化字符串和参数创建一个新的错误值。例如：

```go
return nil, fmt.Errorf("error occurred: %v", someValue)
```

这样可以更方便地生成自定义的错误信息。

此外，Go 还支持自定义错误类型。开发人员可以通过定义满足 `error` 接口的自定义类型来表示特定的错误。这样可以提供更丰富的错误信息和错误处理逻辑。

Go 的错误处理机制基于错误类型和错误值。通过返回错误值，并使用条件语句进行错误检查，开发人员可以有效地处理和传播错误信息。

除了使用错误值进行错误检查外，Go 还提供了另外两种错误处理方式：错误恢复（Error Recovery）和错误日志记录（Error Logging）。

## 错误恢复

在某些情况下，当程序遇到错误时，我们可能希望程序能够继续执行而不是立即终止。为了实现这种错误恢复的能力，Go 提供了 recover 函数和 panic 机制。panic 用于引发一个错误，并立即停止当前函数的执行，然后程序会开始回溯执行调用栈，直到遇到包含 recover 函数的延迟函数调用。recover 用于捕获 panic 引发的错误，并允许程序进行一些处理。通过使用 defer 关键字和 recover 函数，我们可以在一些关键的代码段中设置恢复机制，以确保程序在遇到错误时能够继续执行，并进行一些必要的清理操作。

```go
func process() {
	defer func() {
		if err := recover(); err != nil {
			fmt.Println("Recovered from error:", err)
		}
	}()

	// 执行可能引发错误的代码
	// 当遇到错误时，使用 panic 引发错误
	panic("something went wrong")
}
```

process 函数中的 panic 语句会引发一个错误，并立即停止函数的执行。但由于设置了延迟函数调用和 recover 函数，程序会继续执行 defer 块中的代码，捕获错误并进行处理。

## 错误日志记录

除了简单地检查错误和恢复错误外，有时我们还需要记录错误信息以进行故障排查和日志记录。在 Go 中，通常使用标准库中的 log 包或第三方日志库（如 logrus、zap 等）来记录错误日志。这些库提供了各种级别的日志记录功能，可以将错误信息和其他相关信息写入日志文件或其他输出目标。

```go
package main

import (
	"errors"
	"log"
)

func main() {
	err := someFunction()
	if err != nil {
		log.Println("Error:", err)
	}
}

func someFunction() error {
	return errors.New("something went wrong")
}
```

使用标准库中的 log 包将错误信息记录到日志中。可以使用不同的日志级别（如 Println、Printf、Error 等）根据需要进行日志记录。

如果在错误恢复机制中没有设置延迟函数调用和 recover 函数，那么在 panic 引发错误后，程序将会立即终止并打印出错误信息。这种情况下，错误将无法被捕获和处理，程序会退出。

例如，考虑以下代码：

```go
func process() {
	// 执行可能引发错误的代码
	// 当遇到错误时，使用 panic 引发错误
	panic("something went wrong")
}

func main() {
	process()
	fmt.Println("After process")
}
```

在上述示例中，当 process 函数执行到 panic 语句时，程序会立即终止，并输出以下错误信息：

```shell
panic: something went wrong

goroutine 1 [running]:
main.process()
	/Users/user/main.go:5 +0x39
main.main()
	/Users/user/main.go:10 +0x20
exit status 2
```

可以看到，错误信息指示发生了 panic，并显示了调用栈的信息。然后，程序会退出，并不会继续执行 fmt.Println("After process") 这行代码。

因此，在错误恢复机制中，如果没有设置延迟函数调用和 recover 函数，panic 引发的错误将会导致程序的立即终止。为了能够恢复错误并继续执行程序，必须使用 defer 关键字和 recover 函数来捕获和处理错误。


Go 的错误处理主要基于两个概念：错误类型和错误值。

Go - Error


Logical Properties 是 CSS3 中引入的一个新特性，它是一个基于逻辑方向的属性系统，主要是为了支持从右向左（RTL）语言的页面设计而引入的。在传统的 CSS 盒模型中，宽度和高度、内边距和边框等属性都是基于物理方向来计算的（如左、右、上、下等），而在 RTL 语言中，这些属性需要根据从右向左的方向来计算。Logical Properties 则提供了一种基于逻辑方向的属性系统，这些属性会自动根据文本的方向进行翻转，从而能够更方便地支持多种语言和布局方式。

Logical Properties 包括以下几种属性：

- inline-size 和 block-size：代表元素的宽度和高度，根据文本的方向而自动调整。
- margin-inline 和 margin-block：代表元素的内边距，也可以用于设置外边距。
- padding-inline 和 padding-block：代表元素的内边距。
- border-inline 和 border-block：代表元素的边框。

其中，inline-size 和 block-size 可以理解为宽度和高度的逻辑属性，可以根据文本方向自动切换。而 margin-inline 和 padding-inline 则代表文本方向上的外边距和内边距，而 margin-block 和 padding-block 则代表块方向上的外边距和内边距。

例如，如果要在一个从右向左的页面中，将一个 div 元素水平居中，可以使用以下代码：

```css
div {
  margin-left: auto;
  margin-right: auto;
  margin-inline-start: 0;
  margin-inline-end: 0;
}
```

在上述代码中，margin-left 和 margin-right 控制了 div 元素的左右外边距，而 margin-inline-start 和 margin-inline-end 控制了 div 元素在文本方向上的外边距，从而实现了水平居中的效果。

需要注意的是，Logical Properties 只在支持 CSS3 的浏览器中才能使用。如果需要在旧版浏览器中使用 Logical Properties，可以考虑使用 Polyfill 或者手动转换为传统的物理属性来实现。


css - Spacing


[//]: # (https://www.freecodecamp.org/news/set-and-map-in-javascript/)
## Sets

`Sets`对象是值的集合，它不允许重复的值，并且是无序的。

```js
// 创建 Set 对象
const emptySet = new Set()
// 添加元素到 Set 对象
emptySet.add('red').add('green').add('blue')
// 移除元素
emptySet.delete('red')
// 检查是否包含某个值
emptySet.has('green') // true
// 清除所有元素
emptySet.clear()
// 迭代 Set 对象
for (let item of emptySet) {
  console.log(item) // 'green', 'blue'
}
// 将 Set 对象转换为数组
;[...emptySet] // ['green', 'blue']
Array.from(emptySet) // ['green', 'blue']
```

去重

```js
Array.from(new Set(['red', 'green', 'blue', 'red', 'green', 'blue'])) // ['red', 'green', 'blue']
```

创建一组 Unicode 字符

```js
new Set('abc')
new Set(['a', 'b', 'c'])
assert.deepEqual(new Set('abc'), new Set(['a', 'b', 'c'])) // true
```

与映射键一样，`Set`元素与===进行比较，唯一不同的是`NaN`等于自身，但是`object`不等于自身。

```js
const set = new Set([NaN, NaN, NaN]) // Set { NaN }
set.size // 1
set.has(NaN) // true

const set2 = new Set()
set2.add({})
set2.size === 1 // true
set2.add({})
set2.size === 2 // true
```

合并两个 Set

> 计算两个集合 a 和 b 的并集意味着创建一个包含 a 和 b 元素的集合。

```js
const a = new Set([1, 2, 3]) // Set { 1, 2, 3 }
const b = new Set([4, 3, 2]) // Set { 2, 3, 4 }
const union = new Set([...a, ...b]) // Set { 1, 2, 3, 4 }
```

Set 的交集

> 计算两个集合 a 和 b 的交集意味着创建一个集合，其中包含 a 中也在 b 中的元素。

```js
const a = new Set([1, 2, 3]) // Set { 1, 2, 3 }
const b = new Set([4, 3, 2]) // Set { 2, 3, 4 }
const intersection = new Set(Array.from(a).filter((x) => b.has(x))) // Set { 2, 3 }
```

Set 的差集

> 计算两个集合 a 和 b 之间的差意味着创建一个集合，其中包含不在 b 中的 a 元素。此操作有时也称为减号(−).

```js
const a = new Set([1, 2, 3]) // Set { 1, 2, 3 }
const b = new Set([4, 3, 2]) // Set { 2, 3, 4 }
const difference = new Set(Array.from(a).filter((x) => !b.has(x))) // Set { 1 }
```

遍历 Set

> Set 没有 map 方法

```js
const set = new Set([1, 2, 3]) // Set { 1, 2, 3 }
const mappedSet = new Set(Array.from(set).map((x) => x * 2)) // Set { 2, 4, 6 }
```

过滤 Set

> Set 没有 filter 方法

```js
const set = new Set([1, 2, 3, 4, 5]) // Set { 1, 2, 3, 4, 5 }
const filteredSet = new Set(
  Array.from(set).filter((x) => x % 2 === 0) // Set { 2, 4 }
)
```

## Maps

`Map` 对象保存键值对，并且能够记住键的原始插入顺序。任何值(对象或者原始值) 都可以作为一个键或一个值。

一个 `Map` 对象在迭代时会根据对象中元素的插入顺序来进行 — 一个 `for...of` 循环在每次迭代后会返回一个形式为`[key，value]`的数组。

创建 `Map` 对象

```js
const emptyMap = new Map() // Map {}
emptyMap.size === 0 // true

// 添加键值对
emptyMap.set('foo', 'bar') // Map { 'foo' => 'bar' }

// 复制一个 Map 对象
const copy = new Map(emptyMap) // Map { 'foo' => 'bar' }

//获取键值对
emptyMap.get('foo') // 'bar'

//判断是否存在某个键
emptyMap.has('foo') // true

// 删除键值对
emptyMap.delete('foo') // true
emptyMap.has('foo') // false

// 获取Map对象大小
emptyMap.size // 0

// 删除所有键值对
emptyMap.clear() // Map {}
```

遍历 `Map`

```js
const map = new Map().set(false, 'no').set(true, 'yes') // Map { false => 'no', true => 'yes' }
for (const key of map.keys()) {
  console.log(key) // false, true
}
```

`entries()` 方法返回一个新的包含 `[key, value]` 对的 Iterator 对象，返回的迭代器的迭代顺序与 `Map` 对象的插入顺序相同。

```js
const map = new Map().set(false, 'no').set(true, 'yes') // Map { false => 'no', true => 'yes' }
for (const entry of map.entries()) {
  console.log(entry) // [false, 'no'], [true, 'yes']
}
```

`keys()` 返回一个引用的 `Iterator` 对象。它包含按照顺序插入 `Map` 对象中每个元素的 key 值。

```js
const map = new Map([
  ['a', 1],
  ['b', 2]
])
map.keys() // MapIterator { 'a', 'b' }
```

`values()` 方法返回一个新的 `Iterator` 对象。它包含按顺序插入 `Map` 对象中每个元素的 `value` 值。

```js
const map = new Map([
  ['a', 1],
  ['b', 2]
])
map.values() // MapIterator { 1, 2 }
```

合并两个 `Map` 对象

```js
const map1 = new Map().set(1, '1a').set(2, '1b').set(3, '1c') // Map { 1 => '1a', 2 => '1b', 3 => '1c' }
const map2 = new Map().set(2, '2b').set(3, '2c').set(4, '2d') // Map { 2 => '2b', 3 => '2c', 4 => '2d' }
const map3 = new Map(map1).set(4, '2d') // Map { 1 => '1a', 2 => '2b', 3 => '2c', 4 => '2d' }
```


Sets对象允许存储唯一的值，而Map对象允许存储键值对。

Sets & Maps


协议（Protocol）是 Swift 中一种重要的类型，它描述了一种方法或者属性的集合。协议可以被任意类型实现，包括类、结构体、枚举和其他协议，从而让这些类型可以拥有相同的行为和接口。

协议定义了一些方法和属性，但不提供任何实现。实现协议的类型，必须遵循协议的要求并提供这些方法和属性的实际实现。

协议的语法如下：

```swift

protocol SomeProtocol {
// 协议定义
}
```

接下来，我们将了解协议的常见用法和特性。

## 协议的属性要求

协议可以要求实现者提供特定名字和类型的实例属性或类型属性。协议不指定属性是存储属性还是计算属性，只指定属性的名称和类型。此外，协议还要求属性是可读写的或只读的。

实现协议的类型，必须遵循协议的要求并提供这些属性的实际实现。如果协议要求实现的属性是可读写的，那么实现者必须提供一个可读写的属性实现；如果协议要求实现的属性是只读的，那么实现者可以提供一个可读的属性实现或一个只读的计算属性实现。

下面是一个协议属性要求的例子：

```swift

protocol Person {
var name: String { get set }
var age: Int { get }
}
```

这个协议定义了两个属性要求，name 和 age。name 是一个可读写的字符串类型的实例属性，age 是一个只读的整数类型的实例属性。

接下来，我们定义一个结构体 Student 来实现 Person 协议：

```swift

struct Student: Person {
var name: String
var age: Int
}
```

Student 结构体实现了 Person 协议，并提供了 name 和 age 属性的实现。由于 Person 协议要求 name 是可读写的，因此 Student 结构体提供了一个可读写的 name 属性实现。而 Person 协议要求 age 是只读的，因此 Student 结构体提供了一个只读的 age 属性实现。

## 协议的方法要求

协议可以要求实现者提供特定名字和类型的实例方法和类型方法。实现协议的类型，必须遵循协议的要求并提供这些方法的实际实现。

和属性要求一样，协议中的方法要求只定义方法名、参数以及返回类型，但不提供具体的实现。实现者必须自行实现这些方法。

下面是一个协议方法要求的例子：

当一个类型符合一个协议时，我们称这个类型为遵循该协议。协议定义了一组要求，遵循该协议的类型必须满足这些要求。

在 Swift 中，协议可以用来实现多态。这意味着，我们可以使用一个遵循该协议的实例来代替任何符合该协议的类型的实例，从而使代码更加通用。

下面是一些常见的协议和它们的使用方法：

## CustomStringConvertible

该协议可以让我们自定义类型的字符串描述。当我们打印一个遵循 CustomStringConvertible 协议的类型时，它将返回一个字符串描述。这在调试和日志记录时非常有用。

下面是一个实现 CustomStringConvertible 协议的例子：

```swift

struct Person: CustomStringConvertible {
let name: String
let age: Int

    var description: String {
        return "\(name), \(age) years old"
    }
}

let person = Person(name: "Alice", age: 28)
print(person) // Output: Alice, 28 years old
```

## Equatable

该协议可以让我们比较两个实例是否相等。当我们需要比较两个对象时，遵循 Equatable 协议的类型会自动获得 == 运算符的实现。

下面是一个实现 Equatable 协议的例子：

```swift

struct Point: Equatable {
let x: Int
let y: Int
}

let point1 = Point(x: 1, y: 2)
let point2 = Point(x: 1, y: 2)

if point1 == point2 {
print("The two points are equal.")
} else {
print("The two points are not equal.")
}
```

## Hashable

该协议可以让我们将一个类型实例转换为一个唯一的哈希值。遵循 Hashable 协议的类型可以用作字典的键或集合的元素。

下面是一个实现 Hashable 协议的例子：

```swift

struct User: Hashable {
let id: Int
let name: String
}

let user1 = User(id: 1, name: "Alice")
let user2 = User(id: 2, name: "Bob")

var userDict = [user1: "Alice", user2: "Bob"]
print(userDict[user1]) // Output: Optional("Alice")
```

## Codable

该协议可以让我们将一个类型编码为 JSON 或解码 JSON。遵循 Codable 协议的类型可以通过编码和解码操作在 Swift 和其他语言之间进行转换。

下面是一个实现 Codable 协议的例子：

```swift

struct Person: Codable {
let name: String
let age: Int
}

let person = Person(name: "Alice", age: 28)

let encoder = JSONEncoder()
let data = try encoder.encode(person)

let decoder = JSONDecoder()
let decodedPerson = try decoder.decode(Person.self, from: data)

print(decodedPerson) // Output: Person(name: "Alice", age: 28)
```


协议可以被任意类型实现，包括类、结构体、枚举和其他协议，从而让这些类型可以拥有相同的行为和接口。

Swift - 协议


Next.js 预渲染支持两种方式：

- SSG 预渲染
- SSR 预渲染

## SSG 预渲染

SSG 预渲染是指在构建时生成 HTML，可以在没有数据的情况下完成，在这种情况下，HTML 页面将准备就绪，而无需预先获取数据，然后开始渲染。

数据可以稍后或应要求提供。

优点：这种方式可以解决白屏问题、SEO 问题
缺点：所有用户看到的都是同一个页面，无法生成用户相关内容

```js
import Link from 'next/link'
import Head from 'next/head'
import Container from '../../components/container'

export default function FirstPost(props) {
  return (
    <>
      <Container>
        <Head>
          <title>My First Post</title>
        </Head>
        <h1>My First Post</h1>
        <h2>
          <Link href="/">
            <a>Home</a>
          </Link>
          <div>Next stars: {props.stars}</div>
        </h2>
      </Container>
    </>
  )
}

export async function getStaticProps() {
  const res = await fetch('https://api.github.com/repos/vercel/next.js')
  const json = await res.json()
  return {
    props: {stars: json.stargazers_count}
  }
}
```

## SSR 预渲染

后端将页面渲染，返回 HTML String 格式，传递到前端，前端进行 hydrate() ,会保留 HTML 并附上时间监听，也就是说后端渲染 HTML，前端添加监听。

前端也会渲染一次，用以确保前后端渲染结果一致

每个组件都有一个特殊的方法`getStaticProps`，可用于获取数据并作为页面的属性传递数据。

## 使用 getServerSideProps

```js
import Link from 'next/link'
import Head from 'next/head'

function HomePage(props) {
  return (
    <>
      <Head>
        <title>Welcome to Next.js!</title>
      </Head>
      <div>Welcome to Next.js!</div>
      <Link href="/posts/first">
        <a>First Post</a>
      </Link>
      <br />
      <div>Next stars: {props.stars}</div>
      <img src="/logo.png" alt="TutorialsPoint Logo" />
    </>
  )
}

export async function getServerSideProps(context) {
  const res = await fetch('https://api.github.com/repos/vercel/next.js')
  const json = await res.json()
  return {
    props: {stars: json.stargazers_count}
  }
}

export default HomePage
```

启动服务

```bash
npm run dev
```
