Skip to content

Conversation

@jmagman
Copy link
Member

@jmagman jmagman commented Sep 25, 2020

  1. pod setup is no longer required as of CocoaPods 1.8. Remove it.
  2. Fix Xcode casing.
  3. Add link to CocoaPods installation docs.
  4. Add note about Ruby version managers not requiring sudo.
  5. Add caveat that CocoaPods is only needed when using Flutter plugins.

flutter/flutter#10122 (comment)
Fixes flutter/flutter#65131.

@jmagman jmagman requested a review from sfshaza2 September 25, 2020 02:52
@jmagman jmagman self-assigned this Sep 25, 2020
@googlebot googlebot added the cla: yes Contributor has signed the Contributor License Agreement label Sep 25, 2020
[Check the app's Bundle ID]: /images/setup/xcode-unique-bundle-id.png
[Choosing a Membership]: https://developer.apple.com/support/compare-memberships
[Mac App Store]: https://itunes.apple.com/us/app/xcode/id497799835
[Flutter plugins]: /docs/development/packages-and-plugins/using-packages
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wanted to link somewhere more specific that explained what plugins were (with native code), but I couldn't really find anything. Filed #4661.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for filing that bug, @jmagman. The info is a bit buried on the developing packages page, but both could use some clarification.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah ha, there it is! Will update the link to that anchor.

$ sudo gem install cocoapods
$ pod setup
```
{{site.alert.note}}
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sfshaza2 Would you mind deploying this so we can check if this note messed up the numbering? I know we've needed to add ols in a few places.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

random tangent: you don't need to deploy it to check formatting. You can just follow https://github.com/flutter/website#developing locally.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@xster is correct! Just run the script in tool/serve.sh and you can view it on localhost. You just can't share that link with others. :)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not willing to install nvm and rvm on my development machine. See: this very diff for all the versioning trouble it causes.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ya, it's definitely a hassle. Though on the flip side, fwiw, I never managed to get ruby or python with a reasonably high version to install nicely on mac either without their own ruby or python specific version manager.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You're right, I didn't need rvm, I was just missing jekyll and npx.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This had two #1s, I changed it to ol and lis, now it increments to 1 and 2, and the alphabetized {: type="a"} also looks right.
Screen Shot 2020-09-25 at 6 40 08 PM

Copy link
Member

@xster xster left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

```
{{site.alert.note}}
The default version of Ruby requires `sudo` to install the CocoaPods gem.
If you are using a Ruby Version manager, you may need to run without `sudo`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm under the impression you need 2 indents inside these alerts

$ sudo gem install cocoapods
$ pod setup
```
{{site.alert.note}}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

random tangent: you don't need to deploy it to check formatting. You can just follow https://github.com/flutter/website#developing locally.

Copy link
Contributor

@sfshaza2 sfshaza2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple of minor comments.

you will also need the third-party CocoaPods dependency manager.
1. Install and set up CocoaPods by running the following commands:
1. You may skip this step if your apps do not depend on
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We avoid "may".
=? You can skip this...

[Check the app's Bundle ID]: /images/setup/xcode-unique-bundle-id.png
[Choosing a Membership]: https://developer.apple.com/support/compare-memberships
[Mac App Store]: https://itunes.apple.com/us/app/xcode/id497799835
[Flutter plugins]: /docs/development/packages-and-plugins/using-packages
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for filing that bug, @jmagman. The info is a bit buried on the developing packages page, but both could use some clarification.

@jmagman
Copy link
Member Author

jmagman commented Sep 26, 2020

Ready for re-review, @sfshaza2!

Copy link
Contributor

@sfshaza2 sfshaza2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@sfshaza2 sfshaza2 merged commit 66ceb45 into flutter:master Sep 28, 2020
@jmagman jmagman deleted the ruby-install branch October 20, 2020 00:29
filiph pushed a commit to filiph/website that referenced this pull request Feb 22, 2021
…lutter#4662)

* Remove pod setup instructions, note the sudoless CocoaPods install

* Review edits

* Fix numbering
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla: yes Contributor has signed the Contributor License Agreement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Flutter requires installation and setup of cocoapods in order to deploy apps on iOS devices

4 participants