mirror of https://github.com/flutter/samples.git
Eric Windmill
1 month ago
parent
b023fdabcb
commit
b23c073be5
@ -1,32 +0,0 @@
|
|||||||
# Changelog
|
|
||||||
|
|
||||||
The purpose of this changelog is to track the freshness of samples and which
|
|
||||||
samples reflect *current best practices*. It describes **human-made, significant
|
|
||||||
** changes made to the repository or samples in the repository.
|
|
||||||
|
|
||||||
While all samples in this repository build and run, some of them were written
|
|
||||||
long ago, and no longer reflect what we want developers to learn. For example,
|
|
||||||
samples should have been refactored when Dart 3 released to include patterns and
|
|
||||||
records, where appropriate.
|
|
||||||
|
|
||||||
* **DO include:**
|
|
||||||
* The addition of new samples.
|
|
||||||
* The removal of existing samples.
|
|
||||||
* Considerable refactoring of any given sample.
|
|
||||||
|
|
||||||
* **DO NOT include:**
|
|
||||||
* Simple changes that reflect minor version bumps in Flutter. For example,
|
|
||||||
in a recent Flutter update, `Color.red` became `Color.r`.
|
|
||||||
* Dependency updates.
|
|
||||||
* Bug fixes.
|
|
||||||
* Any changes made to simply 'keep the lights on'.
|
|
||||||
|
|
||||||
# Log
|
|
||||||
|
|
||||||
| DATE (YYYY-MM-DD) | Sample(s) | author | Changes |
|
|
||||||
|-------------------|-------------------|--------------|-----------------------------------------------|
|
|
||||||
| NEXT GOES HERE | | | |
|
|
||||||
| | | | |
|
|
||||||
| 2024-12-04 | N/A - repo change | ericwindmill | Added changelog |
|
|
||||||
| 2024-11-27 | fake_sample | ericwindmill | Refactored fake_sample to use Dart 3 features |
|
|
||||||
| 2020-04-17 | fake_sample | ericwindmill | Created fake_sample |
|
|
||||||
@ -1,31 +0,0 @@
|
|||||||
# This file configures the static analysis results for your project (errors,
|
|
||||||
# warnings, and lints).
|
|
||||||
#
|
|
||||||
# This enables the 'recommended' set of lints from `package:lints`.
|
|
||||||
# This set helps identify many issues that may lead to problems when running
|
|
||||||
# or consuming Dart code, and enforces writing Dart using a single, idiomatic
|
|
||||||
# style and format.
|
|
||||||
#
|
|
||||||
# If you want a smaller set of lints you can change this to specify
|
|
||||||
# 'package:lints/core.yaml'. These are just the most critical lints
|
|
||||||
# (the recommended set includes the core lints).
|
|
||||||
# The core lints are also what is used by pub.dev for scoring packages.
|
|
||||||
|
|
||||||
include: package:analysis_defaults/flutter.yaml
|
|
||||||
|
|
||||||
|
|
||||||
# Uncomment the following section to specify additional rules.
|
|
||||||
|
|
||||||
# linter:
|
|
||||||
# rules:
|
|
||||||
# - camel_case_types
|
|
||||||
|
|
||||||
# analyzer:
|
|
||||||
# exclude:
|
|
||||||
# - path/to/excluded/files/**
|
|
||||||
|
|
||||||
# For more information about the core and recommended set of lints, see
|
|
||||||
# https://dart.dev/go/core-lints
|
|
||||||
|
|
||||||
# For additional information about configuring this file, see
|
|
||||||
# https://dart.dev/guides/language/analysis-options
|
|
||||||
@ -1,267 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
|
|
||||||
set -e
|
|
||||||
|
|
||||||
# Configuration
|
|
||||||
LOGS_DIR="logs"
|
|
||||||
LOG_FILE="$LOGS_DIR/flutter_update_$(date +%Y-%m-%d_%H-%M-%S).log"
|
|
||||||
TEMP_LOG="/tmp/flutter_temp_$$.log"
|
|
||||||
|
|
||||||
# Create logs directory if it doesn't exist
|
|
||||||
mkdir -p "$LOGS_DIR"
|
|
||||||
|
|
||||||
# Colors for output
|
|
||||||
RED='\033[0;31m'
|
|
||||||
GREEN='\033[0;32m'
|
|
||||||
YELLOW='\033[1;33m'
|
|
||||||
BLUE='\033[0;34m'
|
|
||||||
NC='\033[0m' # No Color
|
|
||||||
|
|
||||||
# Logging function
|
|
||||||
log() {
|
|
||||||
echo -e "$1" | tee -a "$LOG_FILE"
|
|
||||||
}
|
|
||||||
|
|
||||||
log_error() {
|
|
||||||
echo -e "${RED}ERROR: $1${NC}" | tee -a "$LOG_FILE"
|
|
||||||
}
|
|
||||||
|
|
||||||
log_warning() {
|
|
||||||
echo -e "${YELLOW}WARNING: $1${NC}" | tee -a "$LOG_FILE"
|
|
||||||
}
|
|
||||||
|
|
||||||
log_info() {
|
|
||||||
echo -e "${BLUE}INFO: $1${NC}" | tee -a "$LOG_FILE"
|
|
||||||
}
|
|
||||||
|
|
||||||
# Function to check if directory is a Flutter project
|
|
||||||
is_flutter_project() {
|
|
||||||
local dir="$1"
|
|
||||||
[[ -f "$dir/pubspec.yaml" ]] && grep -q "flutter:" "$dir/pubspec.yaml"
|
|
||||||
}
|
|
||||||
|
|
||||||
# Function to get current Flutter version
|
|
||||||
get_flutter_version() {
|
|
||||||
flutter --version --machine | grep '"frameworkVersion"' | cut -d'"' -f4
|
|
||||||
}
|
|
||||||
|
|
||||||
# Function to update SDK constraints in pubspec.yaml
|
|
||||||
update_sdk_constraints() {
|
|
||||||
local project_dir="$1"
|
|
||||||
local current_version="$2"
|
|
||||||
local pubspec="pubspec.yaml"
|
|
||||||
|
|
||||||
if [[ ! -f "$pubspec" ]]; then
|
|
||||||
log_error "pubspec.yaml not found in $project_dir"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Extract major and minor version numbers
|
|
||||||
local major=$(echo "$current_version" | cut -d'.' -f1)
|
|
||||||
local minor=$(echo "$current_version" | cut -d'.' -f2)
|
|
||||||
local next_major=$((major + 1))
|
|
||||||
|
|
||||||
# Create SDK constraint string
|
|
||||||
local sdk_constraint=">=$current_version <$next_major.0.0"
|
|
||||||
|
|
||||||
# Update only the Dart SDK constraint under environment: section
|
|
||||||
# This specifically targets the sdk: line under environment: and not flutter dependencies
|
|
||||||
if grep -A5 "^environment:" "$pubspec" | grep -q "sdk:"; then
|
|
||||||
# Use perl to update only the environment sdk constraint
|
|
||||||
perl -i -pe '
|
|
||||||
BEGIN { $in_env = 0; }
|
|
||||||
if (/^environment:/) { $in_env = 1; }
|
|
||||||
elsif (/^\w/ && !/^\s/) { $in_env = 0; }
|
|
||||||
if ($in_env && /(\s+sdk:\s*)['\''"]?[^'\''"]*['\''"]?/) {
|
|
||||||
s/(\s+sdk:\s*)['\''"]?[^'\''"]*['\''"]?/$1'\'''"$sdk_constraint"'\''/;
|
|
||||||
}
|
|
||||||
' "$pubspec"
|
|
||||||
log_info "Updated Dart SDK constraint in $project_dir to: $sdk_constraint"
|
|
||||||
else
|
|
||||||
log_warning "No Dart SDK constraint found under environment: in $project_dir/pubspec.yaml"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
# Function to process a single Flutter project
|
|
||||||
process_project() {
|
|
||||||
local project_dir="$1"
|
|
||||||
local project_name=$(basename "$project_dir")
|
|
||||||
|
|
||||||
log ""
|
|
||||||
log "========================================="
|
|
||||||
log "Processing project: $project_name"
|
|
||||||
log "========================================="
|
|
||||||
|
|
||||||
cd "$project_dir"
|
|
||||||
|
|
||||||
# Get current Flutter version for SDK constraints
|
|
||||||
local flutter_version
|
|
||||||
flutter_version=$(get_flutter_version)
|
|
||||||
if [[ $? -ne 0 ]]; then
|
|
||||||
log_error "Failed to get Flutter version for $project_name"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Update SDK constraints
|
|
||||||
log_info "Updating SDK constraints to use Flutter $flutter_version"
|
|
||||||
if ! update_sdk_constraints "$project_dir" "$flutter_version"; then
|
|
||||||
log_error "Failed to update SDK constraints for $project_name"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Update dependencies
|
|
||||||
log_info "Updating dependencies..."
|
|
||||||
if ! flutter pub upgrade > "$TEMP_LOG" 2>&1; then
|
|
||||||
log_error "Failed to upgrade dependencies for $project_name"
|
|
||||||
cat "$TEMP_LOG" >> "$LOG_FILE"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Run pub get
|
|
||||||
log_info "Running pub get..."
|
|
||||||
if ! flutter pub get > "$TEMP_LOG" 2>&1; then
|
|
||||||
log_error "Failed to run pub get for $project_name"
|
|
||||||
cat "$TEMP_LOG" >> "$LOG_FILE"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Run dart analyze and capture output
|
|
||||||
log_info "Running dart analyze..."
|
|
||||||
if ! dart analyze > "$TEMP_LOG" 2>&1; then
|
|
||||||
local exit_code=$?
|
|
||||||
log_error "Dart analyze found issues in $project_name (exit code: $exit_code)"
|
|
||||||
|
|
||||||
# Filter and log only errors, warnings, and infos (not success messages)
|
|
||||||
if grep -E "(error|warning|info):" "$TEMP_LOG" > /dev/null; then
|
|
||||||
log "Analyze results for $project_name:"
|
|
||||||
grep -E "(error|warning|info):" "$TEMP_LOG" >> "$LOG_FILE"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Check if there are fatal errors (errors that would prevent compilation)
|
|
||||||
if grep -E "^error:" "$TEMP_LOG" > /dev/null; then
|
|
||||||
log_error "Fatal errors found in $project_name, skipping further processing"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
# Even on success, check for warnings and infos
|
|
||||||
if grep -E "(warning|info):" "$TEMP_LOG" > /dev/null; then
|
|
||||||
log "Analyze results for $project_name:"
|
|
||||||
grep -E "(warning|info):" "$TEMP_LOG" >> "$LOG_FILE"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Run dart format
|
|
||||||
log_info "Running dart format..."
|
|
||||||
if ! dart format . > "$TEMP_LOG" 2>&1; then
|
|
||||||
log_error "Failed to format code for $project_name"
|
|
||||||
cat "$TEMP_LOG" >> "$LOG_FILE"
|
|
||||||
# Continue anyway, formatting errors are not fatal
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Run tests
|
|
||||||
log_info "Running tests..."
|
|
||||||
if ! flutter test > "$TEMP_LOG" 2>&1; then
|
|
||||||
local exit_code=$?
|
|
||||||
log_error "Tests failed for $project_name (exit code: $exit_code)"
|
|
||||||
|
|
||||||
# Log test failures
|
|
||||||
if grep -E "(FAILED|ERROR|Exception)" "$TEMP_LOG" > /dev/null; then
|
|
||||||
log "Test failures for $project_name:"
|
|
||||||
grep -E "(FAILED|ERROR|Exception)" "$TEMP_LOG" >> "$LOG_FILE"
|
|
||||||
fi
|
|
||||||
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
log_info "Successfully processed $project_name"
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
# Main execution
|
|
||||||
main() {
|
|
||||||
local original_dir="$PWD"
|
|
||||||
log "Flutter Monorepo Update Script Started: $(date)"
|
|
||||||
log "Log file: $LOG_FILE"
|
|
||||||
|
|
||||||
# Check if Flutter is installed
|
|
||||||
if ! command -v flutter &> /dev/null; then
|
|
||||||
log_error "Flutter is not installed or not in PATH"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Upgrade Flutter SDK
|
|
||||||
log ""
|
|
||||||
log "========================================="
|
|
||||||
log "Upgrading Flutter SDK"
|
|
||||||
log "========================================="
|
|
||||||
|
|
||||||
if ! flutter upgrade > "$TEMP_LOG" 2>&1; then
|
|
||||||
log_error "Failed to upgrade Flutter SDK"
|
|
||||||
cat "$TEMP_LOG" >> "$LOG_FILE"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
local flutter_version
|
|
||||||
flutter_version=$(get_flutter_version)
|
|
||||||
log_info "Flutter upgraded to version: $flutter_version"
|
|
||||||
|
|
||||||
# Find all Flutter projects in the current directory
|
|
||||||
local projects=()
|
|
||||||
for dir in */; do
|
|
||||||
if [[ -d "$dir" ]] && is_flutter_project "$dir"; then
|
|
||||||
projects+=("$dir")
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
|
|
||||||
if [[ ${#projects[@]} -eq 0 ]]; then
|
|
||||||
log_warning "No Flutter projects found in the current directory"
|
|
||||||
exit 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
log_info "Found ${#projects[@]} Flutter project(s): ${projects[*]}"
|
|
||||||
|
|
||||||
# Process each project
|
|
||||||
local success_count=0
|
|
||||||
local failure_count=0
|
|
||||||
local failed_projects=()
|
|
||||||
|
|
||||||
for project in "${projects[@]}"; do
|
|
||||||
if process_project "$project"; then
|
|
||||||
((success_count++))
|
|
||||||
else
|
|
||||||
((failure_count++))
|
|
||||||
failed_projects+=("$(basename "$project")")
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Return to root directory
|
|
||||||
cd "$original_dir"
|
|
||||||
done
|
|
||||||
|
|
||||||
# Summary
|
|
||||||
log ""
|
|
||||||
log "========================================="
|
|
||||||
log "Update Summary"
|
|
||||||
log "========================================="
|
|
||||||
log_info "Total projects processed: ${#projects[@]}"
|
|
||||||
log_info "Successful: $success_count"
|
|
||||||
|
|
||||||
if [[ $failure_count -gt 0 ]]; then
|
|
||||||
log_error "Failed: $failure_count"
|
|
||||||
log_error "Failed projects: ${failed_projects[*]}"
|
|
||||||
fi
|
|
||||||
|
|
||||||
log ""
|
|
||||||
log "Flutter Monorepo Update Script Completed: $(date)"
|
|
||||||
|
|
||||||
# Cleanup
|
|
||||||
rm -f "$TEMP_LOG"
|
|
||||||
|
|
||||||
# Exit with error code if any projects failed
|
|
||||||
if [[ $failure_count -gt 0 ]]; then
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
# Run main function
|
|
||||||
main "$@"
|
|
||||||
@ -1,8 +1,25 @@
|
|||||||
You are a Dart developer that maintains this monorepo of Flutter sample projects.
|
You are a Dart developer that maintains this monorepo of sample projects. These are the tasks you need to do when necessary:
|
||||||
|
|
||||||
|
- Update for release of a new version of flutter/dart
|
||||||
|
- Read the release blog posts at (USER WILL PROVIDE)
|
||||||
|
- In the repository, checkout the "beta" git branch and make sure its up to date
|
||||||
|
- Make sure the local flutter SDK is pointing to the beta channel
|
||||||
|
- Run 'tool/release.dart', which will create a log file.
|
||||||
|
- Read the log file and address any issues it describes.
|
||||||
|
- Use the gh cli to make a PR
|
||||||
|
|
||||||
|
- Delete samples and replace with a README
|
||||||
|
- Remove all files within a sample project directory.
|
||||||
|
- Create a README and explain that the project is deprecated.
|
||||||
|
- Look at issues on (USER WILL PROVIDE LINK TO GITHUB ISSUES)
|
||||||
|
- If there are any open issues that describe deleting this sample, link to it in the README
|
||||||
|
|
||||||
|
- Mark stale code
|
||||||
|
- Create a 'stale_code.md' file if it doesn't exist.
|
||||||
|
- For each sample, look at the git logs and find the most recent commit to a .dart file in sample made by a real person.
|
||||||
|
- If that commit was more than one year ago, log it by appending to the stale code log 'sample name, git user name, date of last commit'
|
||||||
|
-
|
||||||
|
|
||||||
|
|
||||||
- Read https://dart.dev/tools/pub/workspaces
|
|
||||||
- Create a gloabl pubspec.yaml and populate it
|
|
||||||
- Determine 5 packages in this repository that could easily be migrated to workspaces.
|
|
||||||
- Migrate those 5 packages.
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in new issue