flutter / website Goto Github PK

On Ubuntu 14.04 (64b TLS) the adb provided via apt is too old.
So I followed the link provided in getting started and downloaded the SDK Tools but it's not obvious what should be done next.

It could be worth to mention somewhere :

• launch tools/android
• install (only?) Android SDK Platfrom-tools
• add platform-tools/ to your PATH
• check that adb devices -l lists your device

On this last item I got an misleading error adb: No such file or directory (or something like that). I figured out that it was because I needed to install lib32stdc++6 package (Actually there's a section Troubleshooting Ubuntu on the Installing the Stand-alone SDK Tools that mentions this package but I did not read it because it was under a section Here are the steps to install Java ) . It would also be nice to mention that issue too.

IIRC, this refers to the MyButton tutorial. Instructions for where to place these images are needed too.

Link to the flutter-dev thread

I was looking at: http://flutter.io/getting-started/ and it lists how to get started on Mac and Linux, but not Windows.

Just browsing around, and I noticed that http://flutter.io/widgets/ doesn't list widgets. I would have expected to see button, radio, etc. Maybe even with screenshots.

Thanks!

Related to #22 - the build failure can be seen here: https://travis-ci.org/flutter/flutter.github.io#L271.

[warning] The method 'debugDumpRenderTree' is not defined for the class 'FlutterBinding' at example/rendering_md_1.dart, line 401.
[warning] Undefined class 'ShrinkWrapWidth' at example/tutorial_md_5.dart, line 220.

[warning] The named parameter 'child' is not defined at example/tutorial_md_5.dart, line 220.
[warning] The named parameter 'child' is not defined at example/tutorial_md_6.dart, line 299.
[warning] The named parameter 'child' is not defined at example/tutorial_md_7.dart, line 417.

@abarth @Hixie

From travis:

1 issue found; analyzed 10 source files in 13.3s.
[warning] The argument type '(BuildContext, Product, int) → dynamic' cannot be assigned to the parameter type 'ItemBuilder' at example/tutorial_md_8.dart, line 472.
The command "./tool/travis.sh" exited with 1.

There's a lot of hotkeys, added by various plugins. Our users don't have a one-stop shop for all hotkeys our workflow exposes.

There's room for a doc that talks about the different syntax and features of Dart, for a JavaScript developer. The places where Dart diverges should be explicitly called out.

The Flutter site and the API docs have different primary colors.

Are we committed to the current Flutter color? I'd like to make the colors the same - either the Flutter color or a new third color.

I see a "Setting up your Android device", but no instructions on what I need to do for my iOS device.

Thanks!

See the getting started guide for example:
http://flutter.io/getting-started/

Tracking issue. There's a few small mentions in the existing tutorial, but routes might warrant more explanation.

In http://flutter.io/tutorial/

Working through the tutorial, I felt myself really wanting to see the most basic example of some UI changing its state. Perhaps a "counter" with a button, which when pressed, updates the count of some text.

IMHO, the Shopping Cart is a bit too complex as an example to show why we need StatefulComponents.

I'd be happy to help write this section if someone wants to contribute the canonical, simple "counter".

Thanks!

Storing data, reading data, etc will be a very common activity in Flutter apps. Let's mention this with perhaps a simple example in the Tutorial.

There's room to show where Dart diverges from ObjectiveC, to aid in the learning curve for new Flutter developers.

We should have a tutorial about how to dig down to the render object layer for cases where you need to do something fancy.

Assuming there are some platform services that don't exist as pre-bundled mojoms/Dart wrappers, we could help new users understand how to build their own mojom to access platform capabilities.

PR coming soon.

Assuming some services come pre-bundled (I don't need to write a mojom), it would be helpful to show our new users how that can:

• find what services are available
• what it means to access a service
• how to use one of the services as an example (e.g. camera)

This is the very first time I enabled developer mode on my phone, and the very first time I tried pushing a flutter demo onto the phone. I apparently wasn't fast enough allowing the USB debugging, and even though I did tap the checkbox and tapped allow, the flutter start command errored like this:

Seths-iMac:my_app sethladd$ flutter start
Downloading Sky Snapshot from the cloud, one moment please...
Downloading Sky Shell from the cloud, one moment please...
warning: Unexpected failure parsing device information from adb output:
84B7N15A07007628       unauthorized usb:437387264X
Please report a bug at http://flutter.io/
severe: Unable to run application - no connected devices.

Maybe we can either wait longer, or check for this error and interpret it as "Please allow USB debugging and try again" ?

Flutter has four main components:

a heavily optimized, mobile-first 2D rendering engine (with excellent support for text)
a functional-reactive framework (optional, you can bring-your-own framework)
a set of Material Design widgets (optional, you can bring-your-own widgets) libraries, tools, and a plugin for Atom

4 components, but 3 bullet points? As well, a comma needed "widgets, libraries, tools, and a".

We have plans, and are building the core framework with those plans very much in mind, but are still building core framework components and so haven't yet implemented those plans.

StatelessComponent.build exists, but StatefulComponent.build 404s.

Did we know that running flutter --version right after a fresh install will run pub get?

Seths-iMac:flutter sethladd$ flutter --version
Updating flutter tool...
Resolving dependencies... (6.6s) 
+ analyzer 0.26.3
+ archive 1.0.20
+ args 0.13.2
+ asn1lib 0.4.1
+ async 1.4.0
+ barback 0.15.2+7
+ bignum 0.0.7
+ charcode 1.1.0
+ cipher 0.7.1
+ collection 1.2.0
+ convert 1.0.1
+ crypto 0.9.1
+ csslib 0.12.2
+ fixnum 0.9.1+2 (0.10.2 available)
+ flx 0.0.10 from path ../flx
+ glob 1.0.5
+ html 0.12.2
+ http_multi_server 1.3.2
+ http_parser 1.1.0
+ logging 0.11.2
+ matcher 0.12.0+1
+ mime 0.9.3
+ mockito 0.10.1 (0.11.0 available)
+ mustache4dart 1.0.10
+ package_config 0.1.3
+ path 1.3.7
+ plugin 0.1.0
+ pool 1.2.1
+ pub_semver 1.2.3
+ shelf 0.6.4+2
+ shelf_static 0.2.3+1
+ shelf_web_socket 0.0.1+4
+ source_map_stack_trace 1.0.4
+ source_maps 0.10.1
+ source_span 1.2.1
+ stack_trace 1.5.0
+ string_scanner 0.1.4
+ test 0.12.5+2
+ typed_data 1.1.1
+ utf 0.9.0+2
+ watcher 0.9.7
+ yaml 2.1.7
Downloading archive 1.0.20...
Downloading mockito 0.10.1...
Downloading test 0.12.5+2...
Downloading analyzer 0.26.3...
Downloading plugin 0.1.0...
Downloading html 0.12.2...
Downloading stack_trace 1.5.0...
Downloading shelf_web_socket 0.0.1+4...
Downloading yaml 2.1.7...
Downloading bignum 0.0.7...
Downloading glob 1.0.5...
Downloading pool 1.2.1...
Downloading pub_semver 1.2.3...
Downloading path 1.3.7...
Downloading package_config 0.1.3...
Downloading asn1lib 0.4.1...
Downloading collection 1.2.0...
Downloading mustache4dart 1.0.10...
Downloading http_parser 1.1.0...
Downloading convert 1.0.1...
Downloading typed_data 1.1.1...
Downloading source_span 1.2.1...
Downloading cipher 0.7.1...
Downloading async 1.4.0...
Downloading shelf 0.6.4+2...
Downloading fixnum 0.9.1+2...
Downloading watcher 0.9.7...
Downloading barback 0.15.2+7...
Downloading csslib 0.12.2...
Downloading logging 0.11.2...
Changed 42 dependencies!
Precompiling executables... 
Loading source assets... 
Precompiled archive:tar.
Precompiled test:test.
flutter version 7be58b1ae0d4bddd181b3f44f509721ab070177f

This may be by design, since we don't ship snapshots. Just double checking this is expected.

So we can search across all our API docs, flutter.io docs, and anything else useful for developers.

From http://flutter.io/tutorial/

"Notice how Counter now delegates responsibility for incrementing and displaying the counter value down to CounterIncrementor and CounterDisplay, respectively."

Is delegates the right word here? Looking at Counter, all it does is create _CounterState.

Maybe: "Notice how we created two new stateless components, cleaning separating the concerns of displaying the counter (CounterDisplay) and changing the counter (CounterIncrementor)."

Thoughts?

Connecting to HTTP (GET, POST) from a Flutter app will be a very common activity. Let's include a mention and example of this in the Tutorial.

• on the homepage
• in the widget gallery
• in the tutorial, showing what each snippet should look like

It would be interesting to write a document that specifically talks to JavaScript and react.js developers. There are enough similarities and differences that we could probably use a doc for this.

In Getting Started there is a link that points to https://github.com/flutter/engine/tree/master/examples/stocks. I'm not sure where it should point (couldn't find the Stocks directory) but it is broken.

Crib from https://source.android.com/source/build-numbers.html

We mention this in Getting Start and the FAQ, if not other places.

sqlite is found in both Android and iOS. We can document and explain how to access sqlite from Flutter.

e.g. do I need a phone? What kind, and version(s)? What OS and what version(s)? Any cables? Do I need other software like XCode?

maybe even show a picture to illustrate the setup.

Any icon mentioned here: https://github.com/flutter/flutter.github.io/blob/master/tutorial.md should be referenced in the flutter.yaml.

There's room to show where Dart diverges from Java, to aid in the learning curve for new Flutter developers.

We can now build an APK for you! :) flutter apk

Let's add this to our docs, enough for users to try it out.

Hi,

The architecture diagrams are fantastic. I'd also love to learn a little more about how the framework manages all the widgets. I see a widget lifecycle diagram, but I'm missing a picture about how the higher-level flow looks like. For example, an input event comes in (e.g., tap) and then... change state in widget, calculate some diff in the tree, ... ?

Thanks!

Sitting here with my son :) trying to build a game with Flutter. I think we want basic dart:ui but I'm not actually sure what that is, to be honest. I see we're generating docs for package:flutter but I didn't see docs for dart:ui.

Are they hosted somewhere? Related, are there any other dart: libraries that I would want to check out?

Thanks!

Looks like it's the overflow-x CSS rule on pre.

Steps to Reproduce

1. Go to the docs page
2. Type yaml into the search box
3. Hit return

Actual Result

Nothing happens

Expected Result

A search-results-page appears for yaml. Since the docs search seems to be entirely powered by a precalculated index, perhaps an autocomplete suggestion that reads "There isn't a docs page for yaml," would suffice.

• What is this file?
• What is it used for?
• What do I put in it?

See also flutter/flutter#300

Looks like https://domokit.github.io/docs/sky/ is out of date. It's still using the sky name and hosted under domokit.

Should we have a Travis process or other automated process to build the API docs for Flutter?